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SYSTEM SERVICE PROGRAMS Update C 


Preface 


This programmer reference manuals is one in a series designed to be used as a quick-reference document 
for programmers familiar with the Unisys Operating System/3 (OS/3). This particular manual describes the 
system service programs. 


The information presented here is limited to facts; no introductory information or examples of use are 
provided. This type of information is in two other OS/3 manuals: an introduction to the system service 
programs, UP-8840 (current version), and a system service program operating guide, UP-8841 (current 
version). 


The information in this manual is presented as follows: 


Section 1. General Information 

Gives a brief description of the system service programs and describes the statement conventions 
used in writing the parameter associated with OS/3 in general and the system service programs in 
particular. 


Section 2. SAT Librarian Control Statements 


Describes the function and parameters of each SAT librarian control statement, in alphabetic order by 
statement mnemonic. 


Section 3. MIRAM Librarian Control Statements 


Describes the function and parameters of each MIRAM librarian control statement, in alphabetical order 
by statement mnemonic. 


Section 3. MIRAM Librarian Control Statements 


Describes the function and parameters of each MIRAM librarian control statement, in alphabetical order 
by statement mnemonic. 


Section 4. Linkage Editor Control Statements 


Describes the functions and parameters of each linkage editor control statement, in alphabetic order by 
statement mnemonic. 


Sections 5 through 15. System Utility Routines 
The system utilities include the initialize disk routine, the assign alternate track routine, the tape prep 


routine, the disk dump/restore routine, the list software maintenance correction routine, the system 
utility copy routines, and the system utility symbiont. 
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a Appendix A. SAT Librarian Functions 





Lists the tasks performed by the SAT librarian. 
a Appendix B. MIRAM Librarian Functions 
Lists the tasks performed by the MIRAM librarian. 
a Appendix C. System Librarian Correction Cards 
Describes the method by which source and nonsource level modules can be corrected. 
rT] Appendix D. Basic Linkage Editor Statement Processing 
Summarizes the use and placement of the linkage editor control statements. 
a Appendix E. Program Names 
Identifies the names of all the system service programs. 
a Appendix F. File Transfer Utility (PCTRAN) 


Summarizes the file transfer utility (PCTRAN) that permits transfer of files between a Unisys personal 
computer (PC) and the Unisys System 80. 


a Glossary 





Defines the terms peculiar to the system service programs. 
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SAT LIBRARIAN 

The SAT librarian is used to maintain the system library files that contain user and system program 
elements. These elements consist of program source code, macro/jproc source code, object code, and load 
code module elements used for program generation or execution. They are created and used by 
components of OS/3 during the normal course of system operation. 

MIRAM LIBRARIAN 

The MIRAM librarian is used to maintain screen format (F-type and FC-type) modules, saved run library 
(J-type) modules, help screen (HELP) modules, and menu (MENU) modules. Although the MIRAM librarian is 


primarily a disk utility, the MIRAM library files may also exist on magnetic tape, diskette, or punched cards 
and may be copied from one medium to another. 


LINKAGE EDITOR 

The linkage editor builds load modules by linking object modules and object module elements residing in the 
system object library file (SY$OBJ), the system job run library file (SY$RUN), or the user object library file. 
The linkage editor control statements govern load module construction by: 

a defining the object modules and module elements to be included in the load module being built; 

a specifying the order in which the object modules are to be linked (load module structure); and 


a specifying the linkage editor options to be in effect during the building period. 


The link-edit function is usually the last step to be performed in the program preparation process. The 
object modules cannot be loaded or executed until they have been processed by the linkage editor. 


SYSTEM UTILITY ROUTINES 

The system utility routines covered in this manual are as follows: 

a Initialize disk (disk prep) and assign alternate track routine (DSKPRP) 
Used to test disks for surface defects, generate initial track records recognized by the operating 
system, and test for defective tracks without destroying the data on that track. Also used to prep 
diskettes. 

a Tape prep routine (TPREP) 
Used to prep magnetic tape volumes for use by OS/3. 


a Disk dump/restore routine (DMPRST) 


Used for dumping disk to tape or diskette, restoring disk from tape or diskette, copying disk to disk, 
and copying tape to tape, or diskette to diskette in either an interactive or batch environment. 
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List software maintenance correction routine (SMCLIST) 





Used to print a listing of the software maintenance corrections contained in the SMCLOG file. 
Diskette copy routine (SUSCPY) 

The diskette copy routine (SUSCPY) is used to copy and verify 8420/8422 diskettes. 

Disk copy routines (SU$C16, SU$C19, and SU$CSL) 


These disk copy routines are used to copy and verify the 8416/8418, 8419, and the 8430/8433 
disks in both interactive and batch environments. 


System utility symbiont (SL$$SU) 
Used to perform different utiltiy operation from the system console. 
Create File Definition Program (CFPD) 


Used for putting large numbers of file declarations (assignment sets) into the system dictonary at one 
time. 


STATEMENT CONVENTIONS 


The conventions used in writing general, SAT librarian, MIRAM librarian, linkage editor, and system utilities 
OS/3 statements are as follows: 


General Conventions 


Positional parameters must be written in the order specified in the operand field and must be 
separated by commas. When a positional parameter is omitted, the comma must be retained to 
indicate the omission, except for omitted trailing parameters. Positional parameters must precede 
keyword parameters. 


A keyword parameter consists of a word or a code immediately followed by an equal sign, which, in 
turn, is followed by a specification. Keyword parameters can be written in any order in the operand 
field. Commas are required only to separate parameters. 


A positional or keyword parameter may contain a sublist of parameters, called subparameters, 
separated by commas and enclosed in parentheses. The parentheses must be coded as part of the 
list. Subparameters within the parentheses retain the comma if a parameter is omitted, except for 
trailing parameters. 


Capital letters, commas, equal signs, and parentheses must be coded exactly as shown. The 
exceptions are acronyms, which are part of generic terms representing information to be supplied by 


the programmer. 


Lowercase letters and words are generic terms representing information that must be supplied by the 
user. Such lowercase terms may contain hyphens and acronyms (for readability). 


Information contained within braces represents mandatory entries of which one must be chosen. 
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Information contained within brackets represents optional entries that (depending upon program 
requirements) are included or omitted. Braces within brackets signify that one of the specified entries 
must be chosen if that parameter is to be included. 


An optional parameter containing a list of optional entries may have a default specification, which is 
supplied by the operating system when the parameter is not specified by the user. Although the 
default may be specified by the user with no adverse effect, it is considered inefficient to do so. For 
easy reference, when a default specification occurs in the format delineation, it is printed on a 
background. If, by parameter omission, the operating system performs some complex processing 
other than parameter insertion, it is explained in an “‘if omitted’’ sentence in the parameter description. 





An ellipsis (series of three periods) indicates the omission of a variable number of entries. 


Commas are required when positional parameters are omitted, except after the last parameter. 


SAT and MIRAM Librarian Conventions 


Control statements may be written in free form. 


Each operation code is composed of an operation identifier, which describes the function. The 
operation code may be followed by a character string signifying options that alter normal processing 
of the function. The character string is separated from the operation identifier by a period. Twenty 
command functions are supported to accomplish the various processes for the SAT librarian, and five 
are supported for MIRAM librarian functions. 


The operand field of each statement is composed of a variable set of positional parameters, some of 
which are optional. Optional parameters are indicated by brackets; choice alternatives are indicated by 


braces. Operands must be separated from the operation field by at least one blank space. 


Commas are required when positional parameters are omitted, except after the last parameter 
specified. 


Example: 


positional -parameter-1,positional -parameter-2,,positional -parameter -4 


Prime librarian control statements may appear in any logical sequence within the librarian update 
control stream. Subfunction control statements must follow their associated prime control statements. 


Each file and module name may be composed of up to eight characters. Inserted comments describing 
specific modules may consist of up to 30 characters, including embedded blanks. 


The coding format of all the librarian control statements is: 









10 AOPERATIONA 





16 OPERAND 73 SEQUENCE 











unused function [.options] p1,p2,p3,p4,p5 seq-no 


where: 


function 
Is the mnemonic of the librarian process to be performed. 
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Is a string of one or more of the following letters, depending on the specified function. 


A Specifies that all groups with the specified name are to be processed. (G option must also 
be used.) 

C Specifies that the name parameter in the operand field is a module name prefix or a group 
name prefix rather than a complete name. 

D = Specifies that the entire module or module group being processed is to be listed on the 
librarian map. (This may also be used to obtain a table of contents for a specified library 
file.) 

E Specifies that the card modules are terminated when the librarian detects the first EOD 
statement following the ELE statement in the control stream. 

G Specifies that the name parameter in the operand field is a group name, rather than a 
module name. This option initiates processing of only one group unless the C or A option is 
also specified. Whenever this option is used, the module type parameter must be omitted 
from the operand field. 

M_ Specifies that the module identified in the operand field is to be processed only if a like 
module is in the output file. 

N Specifies that the printing of header records on the librarian map is to be suppressed. 

P Specifes that the entire module or module group being processed is to be reproduced on 
punched cards. 

Q = Specifies that the module identified in the operand field is to be processed only if no like 
module is in the output file. 

U Specifies that processing is to be performed on all modules from the current position of the 
file up to and including the module identified in the name parameter. Whenever this option 
is used, the type of the module identified in the name parameter must also be specified in 
the operand field, unless the G option is also being used. 

X Extend an unblocked, single phase, load module. 

NOTES: 

1. If contradictory options are specified for a single SAT or MIRAM librarian function, a 
diagnostic message is printed on the librarian map, and the last specified option is honored. 

2. Unless the RES control statement is specified, the file pointer is positioned at the current 
position of the file, rather than at the beginning of the file. Therefore, when using options C, 
G, or U, specify the RES control statement to access the entire file. 

p1 


1. Is a logical file name. 
2. \s a group name. 
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p2 

1. Is a module type. 

2. Is a logical file name. 

3. Is a sequence control field. 
p3 

1. Is a module name. 

2. Is a sequence control field. 
p4 

1. Is a logical file name. 

2. Is a comment. 

3. Is a sequence control field. 
p5 

Is a comment. 
seq-no 


Is a 1- to 8-character alphanumeric sequence control number of which at least one 
character must be numeric. 


Linkage Editor Conventions 


The coding format of all the linkage editor control statements is: 





10 AOPERATIONA/16 OPERAND 


















1 tO 8 
characters 


Must be 
delimited by 
blank columns 


Cannot extend beyond column 71; Not used 
continuation statements are not 


allowed 





The label field begins in column 1, is ended by a blank column, and may contain up to eight 
alphanumeric characters. This field is blank for all linkage editor control statements except the equate 
statement and comment cards, which contain an asterisk in column 1. 


The operation field, which must be preceded and followed by at least one blank column, contains the 
operation code of the function to be performed. If the label field is blank, this field may start in column 
2. 


The operand field begins with the first nonblank character following the operation field, is ended by a 
blank column, and cannot extend beyond column 71. The field may contain multiple operands, 
depending on the function to be performed, and these operands must be separated by commas. 


Continuation statements are not allowed. 
Comment statements, which are identified by an asterisk in column 1, may appear anywhere in a 


linkage editor control stream. Comments are printed on the process map portion of the link-edit map. 
They do not begin any processing by the linkage editor. 














2. SAT Librarian (LIBS) Control Statements 
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BLK 


Function: 
Used to convert your standard load module to a block load module. Block load modules increase the 


efficiency of program loading by allowing all or large parts of overlay phases to be loaded by a single 
1/O operation. 


Format: 





OPERAND 
input-lfn,module-name[,output-lfn][,VERASG=n/n/n] 





AOPERATIONA 





LABEL 





unused 


Parameters: 


input-lfn 
Logical file name of the disk file. 


module-name 
Is a 1- to 6-alphanumeric character string specifying the name of the load module being blocked. 


@ output-lfn 
Logical file name of the disk file being used as output. 


If omitted, the input file contains the blocked load module, and the original load module is nullified. 


VERASG=n/n/n 


Is hexadecimal number O-255 specifying the version and subversion numbers to be applied to 
the block load module. Should be specified as the last parameter when used with positional 


parameters. 


If omitted, version number is not applied. 


_ 
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BOG 


Function: 


Begins a module group by writing a beginning-of-group record in a specified disk or tape file. 


Format: 






AOPERATIONA OPERAND 






group-name tees 






unused 





Parameters: 


group -name 
One to eight alphanumeric characters specifying the name of the module group being started. 


lfn 
Logical file name of the disk or tape file on which the beginning of module group record is 


written. 


If omitted, SYSRUN is used. 
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COM 


Function: 
Permits the comparison of a single source or proc module in two separate files on a record-by-record 
basis or the comparison of two complete files on a block-by-block basis. No other options are 


available with this statement. 


Format: 







LABEL AOPERATIONA OPERAND 


Seaman} [st 





unused 





y [,name],sec-lfn 


Parameters: 


prim-lfn 
Logical file name of the disk or tape file used in the comparison. 


If omitted, $Y$RUN is used. 


Ss, M 
Specifies the type of modules being compared as either a program source module (S) or 
macro/jproc module (M). 


If omitted, all modules in both files are compared. 


n-n 
Two decimal numbers separated by a hyphen; specifies the starting and ending columns of the 
sequence control field used if a source level module is compared. 


If name is not specified, this parameter is ignored. 


name 
One to eight alphanumeric characters specifying the name of a source module being compared. 
The module named is first located in both files, then compared. Each module must be a source 
or proc module. 


If omitted, the files designated are compared on a block-by-block basis from beginning to end, and the 
name parameter is ignored. 


sec-lfn 
Logical file name of the second disk or tape file used in the comparison. 
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COP 


Function: 


SYSTEM SERVICE PROGRAMS 


Used to copy an entire library file, module groups, or specific individual program modules. It effectively 
produces a new library file and allows for an exclusive reproduction of one module or group or the 
inclusive reproduction from the current file position, up to and including the named module or group. 
The copy is selective if all code of a certain type is being copied. Modules or groups of modules may 
be listed, punched, or copied. File compression is performed as the new file is created, thus 
eliminating file fragmentation created by nullified modules or module groups. 


NOTE: 


When you use the copy facility to create a new tape file and want only the modules being copied to 
make up the new file, you must use a previously prepped tape free of any data. You must follow this 
procedure because the copy facility does not reinitialize an output file. All modules being copied are 
automatically written to the end of your output file. 





Format: 
LABEL AOPERATIONA OPERAND 
unused COP[.options] input-tfn ,(S) 7] C,name][,output-l fn] 
; M 
0 
L 
[, VERASG=n/n/n] 
Options: 

A Process all groups specified by the name parameter. (The G option must also be used.) 

Cc Name specified in the name parameter is either a module name prefix or group name prefix. 

D ___List all the modules copied, or if a table of contents is being produced, list all the records in the 
file directory. 

G Name specified in the name parameter is a module group name or a module group name prefix if 
the C option is also specified. If neither the C option nor the A option is used, process only the 
first group found with the specified name. If the C option is used, process all groups with the 
specified prefix. If the A option is used, process all groups with the specified name. If the G 
option is used, the module type parameter should be omitted. 

M_ Copy a specified module from the input file to the output file only if it causes an existing module 
in the output file to be deleted. 

N Do not list any header records. 

P Punch all modules processed. This option cannot be used when requesting a table of contents 


for a file. 
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COP 


Q Copy a specified module from the input file to the output file only if it does not cause an existing 
module in the output file to be deleted. 


U Process the modules from the current position of the input file, up to and including the specified 
module or module group. This option is ignored when producing a table of contents for a file. 


Parameters: 


input-lfn 
Logical file name of the disk or tape input file. 


If omitted, $Y$RUN is used. If used with the D option, one trailing comma, and no other parameters, 
all modules in the file are listed on the librarian map, but no copy operation is performed. 


Ss, M, 0, L 
Type of module being copied as program source (S), macro/jproc (M), object (O), or load (L). 


If omitted, all modules with the specified name are copied. 


name 
One to eight alphanumeric characters specifying the module name, name prefix (C option}, o 
name of the group (G option) copied. 


If omitted, all modules from current position to the end of file of the specified file type are copied. If 
no type or name is specified, all modules from current position to end of file are copied. 


output-lfn 
Logical file name of the disk or tape output file used in the copy operation. The output file 
specification is not necessary to position a file, to list a disk file directory, or to list and punch 
specified modules in a file. 


if omitted, only a subfunction (list, punch, position) of the COP statement is performed. However, if an 
input-lfn, module-type, and module-name are specified but the output-lfn is omitted, the file pointer is 
positioned to the next module after the specified module in the file. 


VERASG=n/n/n 
Specifies a version number consisting of three subversion fields, where the value specified for 
each field may be a decimal number from O to 255. This parameter should be specified last 
when used with positional parameters. 


If omitted, a version number is not applied. 
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COR 


Function: 





Used to correct either program source (S), macro/jproc (M), object (O), or load (L) modules. Correction 
cards follow this statement, specifying how the module is to be corrected. The librarian EOD 
statement indicates the end of the correction cards. The corrected module may be output to the same 
or another disk file. 


Correction cards are based upon the type of module (source or nonsource). For a description of the 
correction cards used with the COR statement, see Appendix C. 


Deletion or reorganization of source module records is accomplished by using REC, SEQ, and SKI as 
subfunctions of the statement. 








Format: 
LABEL AOPERATIONA OPERAND 
unused COR[.options] ta ag ,(S\,name[,output-lfn}(,n£/n£/n1 J] 
oe ‘i 
0 
L 
{, VERASG=n/n/n) 
Options: 


E Terminate at the first EOD card. 
N Do not list header records, subfunction control statements, or records added or deleted. 
P Punch module. 

Parameters: 


input-lfn 
Logical file name of the disk or tape file containing the module being corrected. 


If omitted, $YSRUN is used. 


S, M, O, L 
Type of module being corrected as program source (S), macro/jproc (M), object (O), or load 
(L). 

name 


One to eight alphanumeric characters specifying the name of the module being corrected. If tapes 
are being used, two unique files are required. & 
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COR 


output-lfn 
Logical file name of the disk or tape file into which the corrected module is placed. 


If omitted, a delete/add operation is performed within the input file. 


n/n/n 
Specifies the version number of the module being corrected. Each of the three subfields may be 
a decimal number from O to 255. This parameter specification is used for comparison purpose to 
verify proper module selection before correction is applied. 


If omitted, no verification is conducted. 

VERASG=n/n/n 
Specifies the version number to be applied to the corrected module. Each of the three subfields 
may be a decimal number from O to 255. This parameter should be specified last when used 


with positional parameters. 


If omitted, a version number is not applied. 
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DEL 


Function: 





SYSTEM SERVICE PROGRAMS 


Used to mark modules or module groups for deletion. Once marked for deletion, the information in the 
module or module group cannot be read or changed. The actual physical deletion is done by the COP 
and PAC control statements. 





Format: 
LABEL AOPERATIONA OPERAND 
unused DEL[L.options] 7{S) 1L,name] 
M 
0 
L 
Options: 

A __ Delete all groups with the specified group name. (The G option must also be used.) 

Cc Name specified in the name parameter is either a module name prefix or a group name prefix. 

D List deleted modules. 

G Name specified in the name parameter is a module group name or a module group name prefix if 
the C option is also specified. If neither the C option nor the A option is used, delete only the 
modules in the first group found with the specified name. If the C option is used, delete all 
module groups with the specified group name prefix. If the A option is used, delete all module 
groups with the specified group name. If the G option is used, the module type parameter should 
be omitted. When a module group is deleted, the BOG and EOG records associated with the 
group are also deleted. 

N Do not list header records of deleted modules. 

P Punch deleted modules. 

U Deletion starts at current file position and continues up to and including the named module. If a 
module name is specified, then a type must also be included. If module name is omitted, delete 
rest of file. 

Parameters: 

Lfn 


Logical file name of the disk file. 


If omitted, $Y$RUN is used. 
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S DEL 


S, M, 0, L 
Type of module to be deleted — program source (S), macro/jproc (M), object (O), or load (L). 


if omitted, delete all modules explicitly named, regardless of type. 
name 


One to eight alphanumeric characters specifying a name for the module or module prefix being 
deleted. 


If omitted, all modules of specified type are deleted. If both type and name are omitted, all remaining 
modules are deleted. 
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a ee Se 


ELE 





Function: 


Adds a program source (S), object (O), macro/jproc (M), or load (L}) module (contained on cards) to a 
disk or tape file. If a card file element is being added to a disk file that already contains a module of 
the same name and type, the old module is replaced by the new module. A module header record is 
inserted in the specified output file. All cards immediately following the ELE card down to the EOD 
card are assumed to be the module being added. Librarian control streams are valid source modules, 
but each EOD card that is a part of that control stream must be associated with its own correct 
module (COR) or ELE control statement. The librarian does not terminate the add module operation 
until an unattached EOD card is detected, unless the E option is specified. 





Format: 
LABEL AOPERATIONA OPERAND 
unused ELE[.options] ,{(S\ },name[, comments] 
: M 
0 
L 
Options: 





D List the module being added. 

E Terminate at the first EOD. 

N Do not list the header record. 

P Punch the module being added. 
Parameters: 


lfn 
Logical file name of the disk or tape file to which this card module is added. 


If omitted, SYSRUN is used. 


Ss, M, 0, L 
Type of module being added as program source (S), macro/jproc (M), object (O), or load (L). 


name 
One to eight alphanumeric characters that specify a name for the module being added. 


For object and load modules, the name on the ELE card must be the same as the name of the 
module. 





comments 
Up to 30 characters to be inserted into the module header record. 


If omitted, no comment is included in the header record. 
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EOD 


Function: 


Ends the correction card data that follows either an ELE, COR, or REPRO control statement. Each EOD 
card must be associated with one and only one ELE or COR card. 


Format: 






AOPERATIONA OPERAND 


unused unused 
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EOG 


Function: 
Ends a module group by writing an end-of-group record in a specified file. 


Format: 


AOPERATIONA OPERAND 













eroaun 


unused group-name ' 





Parameters: 


group -name 
Name of the module group being ended. 


lfn 
Logical file name of the disk or tape file in which the end-of-group record is written. 


If omitted, SYSRUN is used. 
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® ESC 


Function: 


Causes the librarian to read all subsequent librarian statements from the librarian created disk source 
module. Processing ends when an end of module (librarian) is detected. 


Format: 






AOPERATIONA OPERAND 


unused filename,LD,modulename 


Parameters: 


filename 
Specifies the name of the file containing the librarian control stream. 


LD 
Indicates the control stream is in a librarian-created source module. 


modul ename 
Specifies the name of the librarian source module containing the control stream to be processed. 
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FIL 
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Function: 


Declares to the librarian all tape, disk, and diskette files that are referenced subsequently in the control 
stream. It assigns to each file a type code (D for disk or format label files on diskette and T for tape 
or data set label files on diskette). It also assigns a logical file number (O—15), which together with the 
type code, forms a logical file name that is used for all subsequent file references within the librarian 
control stream. File declarations may be strung out in one FIL statement or may be made in separate 
FiL statements. An appropriate control file declaration statement is required in the job control stream 
for each file described by the FIL statement, unless a job run library is being used. 








Format: 
LABEL AOPERATIONA OPERAND : 
unused a aca vee, fTn}=filename-n 
Dn Dn 


Parameters: 


Tn- filename 
Equates a tape file or data set label file on diskette (filename) with a logical file name of TO 
through T15. 


Dn- filename 
Equates a disk file or format liabel file on diskette (filename) with a logical file name of DO 
through D15. 


NOTE: 


The file name specification may not exceed eight alphanumeric characters and must begin with an 
alphabetic character. Equating the names of files to be processed with logical file names allows a 
single LIBS control stream to be used to maintain any number of different files. (Functions performed 
by the control stream use the logical file specifications.) When files change, only the FIL statements 
need be modified; thus each command to the librarian need not specify the actual file name used. 
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LST 


Function: 
Displays the contents of a file in alphabetical sequence. 


Format: 


LABEL AOPERATIONA OPERAND 


=a 





Parameters: 


input-lfn 
Logical file name of disk file containing the modules to be listed. 


If omitted, $YSRUN is used. 
S, M, 0, L 
Type of module being printed is either program source (S), macro/jproc (M), object (O), or load 


(L). 


If omitted, entire file is listed. 
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PAC 


Function: 


Used to condense a library file by discarding any modules that were marked for deletion and 
squeezing the remaining modules together. This function may be used with DEL and ADD control 
statements to build a reordered, updated, and packed library file. The printing of header records is 
done for both the modules being packed and the modules not being packed under the headings 
MODULES MOVED and MODULES NOT MOVED, respectively. 


PAC should not be specified to pack a file containing an ICAM symbiont while that symbiont is active. 


Format: 





OPERAND 






AOPERATIONA 
PAC[.options] 





unused 






Options: 
N Do not list header records. 
Parameters: 


lfn 
Logical file name of the disk file being compressed. 


If omitted, SYSRUN is compressed. 











UP-8842 Rev. 3 SPERRY OS/3 2-17 
SYSTEM SERVICE PROGRAMS 


PAGE 


Function: 


Causes the librarian to start a new page on the librarian map. It may also specify a header line to be 
printed at the top of that new page and each succeeding page for the duration of the job step or until 
another PAGE statement is encountered. 


Format: 

LABEL AOPERATIONA OPERAND 

unused PAGE {'header-line'] 
Parameter: 


"header -line! 
Specifies the contents of the header line to be printed at the top of the new page and each 
succeeding page. The header line must be enclosed in single quotation marks and can be up to 


64 characters in length. 
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PARAM ERROR 
LIBOP ERROR 


Function: 


These statements cause the librarian to terminate in the event of an error. They may cause normal 
termination of the librarian job step only (STOP) or abnormal termination of the entire job (CANCEL). 


Format 1: 


fe PARAM) ERROR=STOP 
LIBOP 


Parameter: 


ERROR=STOP 
Terminates the job step normally when an error is encountered. Any subsequent job steps 


are executed. 


Format 2: 


// PARAM) ERROR=CANCEL 
LIBOP 


Parameter: 


ERROR=CANCEL 
Abnormally terminates the entire job when an error is encountered. 


NOTE: 


The // PARAM statement must follow the // EXEC LIBS statement and precede the /$ statement in the job 
control stream. 
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PARAM PRINT + 
LIBOP PRINT 


Function: 


These statements suppress the printing of the librarian map. If used, the printer device assignment set 
need not be included in the librarian job contro! stream. 


Format: 


ie PARAM) PRINT=OFF 
LIBOP 


Parameter: 


PRINT=OFF 
Suppresses printing of the librarian map. 


NOTE: 


The // PARAM statement must be the first // PARAM statement in the librarian job step following the // 
EXEC LIBS statement. It must precede the /$ statement in the job control stream. 
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PARAM PRTCOR 
LIBOP PRTCOR 


Function: 


Causes the librarian to print a before-correction-image of the SAT librarian object or load module field 
to be corrected for verification. 


Format: 


{i ee PRTCOR=ON 
LIBOP 


Parameter: 


PRTCOR=ON 
Turns the print-before-correction-image feature on. 


If omitted, this feature is turned off. 
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PARAM PRTOBJ { 
LIBOP PRTOBJ 


Function: 


These statements cause source or macro/jproc modules to be printed in hexadecimal format. They 
remain in effect for the entire librarian job step. 


Format: 


e el PRTOBJ=ON 
LIBOP 


Parameter: 


PRTOBJ=ON 
Causes source or macro/jproc modules to be printed in hexadecimal format. 


NOTE: 


The // PARAM statement must be placed between the // EXEC LIBS statement and the /$ statement in 
the job control stream. 
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PARAM TAPEFILES 
LIBOP TAPEFILES 


Function: 


These statements to allow multiple files to be written to the same tape volume. All files must be 
written to this volume in a single session when these statements are used. These files cannot be 
extended later. 


As the files are being created, only one file on the tape can be open at a time. Therefore, the same 
logical file name (Tn) must be used for every tape file, and a FiL statement must be used to redefine 


this logical file name each time another file is to be processed. 


lf omitted, only one file can be written to each tape. These statements are not required to read a file 
on a multifile tape. 


Format: 


te ul TAPEFILES=MULTI 
LIBOP 


Parameter: 


TAPEFILES=MULTI 
Allows multiple files to be written to the same tape volume. 





NOTE: 


The // PARAM statement must be placed between the // EXEC LIBS statement and the /$ statement in 
the job control stream. 
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PARAM UPDATE | 
LIBOP UPDATE 


Function: 


These statements are used to specify the date and time to be in effect during the execution of a 
librarian job. The date and time are inserted in the header records of modules being corrected by the 
librarian. If omitted, the date and time contained in the system information block (SIB) are used. The 
date and time remain in effect until the librarian job is terminated. 


Format: 


// dees UPDATE=yymmdd/hhmm 
LIBOP 


Parameters: 


UPDATE=yymmdd/hhmm 
Specifies a date and time to be used for modules being corrected during the execution of the 
job. 


NOTE: 


The // PARAM statement must be placed between the // EXEC LIBS statement and the /$ statement in 
the job control stream. 
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PARAM VERASG 
LIBOP VERASG 


Function: 
Specifies the version number to be assgined to a module copied or created by the librarian. 
Format: 


ie PARAM) VERASG=n/n/n 
LIBOP 


Parameter: 


VERASG=n/n/n 
Version number consisting of three subversion fields, where the value specified in each field may 
be a decimal number from O to 255. 


NOTE: 
The // PARAM statement is used when specifying the version number in your job stream and must 


precede the // EXEC LIBS statement. The LIBOP format is used when accessing the library module via a 
COP, COR, or BLK statement and must precede these statements. 
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REC 


Function: 


Repositions the record pointer of the original program source or macro/jproc module back to the first 
record in the module. Used with the COR control statement to correct source or proc modules. Also 
used with the SKI control statement to rearrange major segments of a program source or macro/jproc 
module. Repositioning of the record pointer occurs immediately if the sequence field of the REC 
statement is blank (omitted). 


Format: 





SEQUENCE 


[last- 
sequence-no.] 


AOPERATIONA OPERAND 


unused 










Parameters: 


last-sequence-no 
One to eight alphanumeric characters identifying the sequence number of the last record to be 
copied into the new data set before the record pointer is repositioned back to the first record in 
the module. This field begins in column 73 unless a SEQ control statement dictates otherwise. 


If omitted, the repositioning operation takes place without any records being copied into the new data 
set. 
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REN 


Function: 


Used to rename a specific module, module group, or record; to change the comment field in a header 
record; or to mark object and load modules as sharable or unsharable. The records that can be 
renamed include control section, common section, and ESD records within object modules and alias 
phase names in load modules. 





Format: 
LABEL AOPERATIONA OPERAND 
unused REN[.options] ofS 
0 
L 
,old-name| .(record-type-and-name) | [,new-name] 
RON 
ROFF 
[,comments] 
Options: 


G Names specified are group names. The first module group encountered with the name identified 
as old-name is to be renamed. 


N Do not list header records. 
Parameters: 

lfn 
Logical file name of the disk file containing the modules being renamed or identified as reentrant 
or nonreentrant. 

If omitted, $Y$RUN is assumed to contain the modules. 

S, M, 0, L 
Type of modules being operated on as program source (S), macro/jproc (M), object (O), or load 


(L). 


If omitted, all modules of the specified old name are affected. 
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REN 


old-name] .( record-type-and-name 


RON 
ROFF 
Identifies the module group, or record to be processed, or the object to be marked as reentrant 
(RON) or nonreentrant (ROFF). The record type codes that may be specified are: 
C Indicates COM. 
E Indicates ENTRY. 
N Indicates procedure name. 
P Indicates alias phase name. 
Ss Indicates CSECT. 
Vs Indicates V-CON. 


Xx Indicates EXTRN. 


Record names can be one to eight characters long. The record type and name specification 
cannot contain any embedded blanks. 


When program source, macro/jproc, object, or load modules are being renamed or their header 
record comment field is being changed, the first 1- to 8-character name is sufficient; if a record 
within an object module is being renamed, record type and old record name also must be 
provided. If an alias phase name is being changed, record type and old alias phase name must be 
specified. 


new-name 


Specifies the new name to be substituted for the old name. If renaming a multiphase load 
module, only the first six characters can be changed; the last two remain the same. If you are 
changing the shareability status of a module or only the comment field of a header record, the 
new name is not necessary. 


comments 


A string of up to 30 characters of comments that is to be inserted into the header record of the 
identified module. 


If omitted, current comments remain unchanged. 
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REPRO 


Function: 


Used to add or delete linkage editor control statements within object modules. If addition is specified, 
the new linkage editor control statements are inserted in the object module immediately after any 
control statements that may already be present in the named object module. If deletion is specified, 
the linkage editor control statements are deleted from either the end of the object module header or 
transfer record and may be replaced with new control statements. 


Two EOD control statements are always required when the REPRO function is specified. The linkage 
editor control statements prior to the first EOD are inserted following the object module header record. 
The control statements after the first EOD are inserted following the object module transfer record. 
The second EOD delimits the control statement insertions. 


Format: 







AOPERATIONA OPERAND 


f 


{,#deletions] 









REPRO[.options] | atime 


Options: 
D List entire module. 
N Do not list header records. 
P Punch module. 
Parameters: 


lfn 
Disk file where object module is located. 


If omitted, $Y$SRUN is used. 


module-name 
Object module being modified. 


#deletions 
Decimal value indicating the number of control statements to be deleted following the object 
module header record. 
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RES 


Function: 


For disk files, resets the current position pointer to the beginning of the file; for tape files, rewinds the 
tape to the load point. When an output tape file is rewound, a tape mark is written before rewinding 
occurs. If a module name and type are specified, the current position pointer in disk or tape files 
points to the first record of the named module. !f a module of the name and type specified is not 
found, the current position pointer remains as it was before the RES statement was processed, 
because the search ends at point of origin, and an appropriate diagnostic is printed on the map. 





Format: 
LABEL AOPERATIONA OPERAND 
unused RES[.options] } /{S\1L,name] 
: M 
(0) 
L 
Options: 


G Name parameter is the name of a group. The file position pointer points to the first record of the 
first group encountered with the name specified. 


Parameters: 


lfn 
Logical file name of the disk or tape file being reset. 


If omitted, resets $Y$RUN. 


Ss, M, 0, L 
Type of module being reset as program source (S), macro/jproc (M), object (O), or load (L). 


If omitted, it is assumed that the reset operation is directed to a file, rather than a module or module 
group. 


name 
Name of the module or module group to which the current position pointer points. 


If omitted and a module type is not specified, it is assumed that the reset operation is directed to a 
file. Otherwise, an error message is listed to indicate its omission. 
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SEQ 


Function: 


Permits the sequence checking, sequencing, or resequencing of program source or macro/jproc 
modules. It does not apply to object or load modules. This statement can be used by itself or with 
the COR or ELE control statements. Used with ELE, it checks sequence numbers already assigned, 
sequences a module‘for the first time, or disregards old sequence numbers and generates new ones in 
a source or proc modules being filed. Used with COR, it enables the correction of a source or 
macro/jproc module by using the sequence numbers for control. 


When the SEQ control statement is used with a tape library, the SEQ control statement must be used \ 
as a subfunction control statement to the COR or ELE control statement. When the SEQ control 
statement is used as a subfunction control statement, any options specified are ignored. 





Format: 
LABEL AOPERATIONA OPERAND 
unused SEQ[ .options] Lfn ,{S)C,module-name] 
SYSRUN M 
dpa eg ‘ 
Options: 


D List sequenced module. 

N Do not list header records. 

P Punch sequenced module. 
Parameters: 


lfn 
Logical file name of the disk file in which the program source or macro/jproc module being 
sequenced or resequenced resides. 


If omitted, SYSRUN is assumed to contain the module. (If a primary function, a delete/add operation is 
performed.) 


S,M 
Specifies the type of module being sequenced as either a program source module (S) or a 
macro/jproc source module (M). 
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@ SEQ 








module-name 
Name of the program source or macro/jproc module being sequenced or resequenced. This 
parameter is required when the SEQ control statement is used as a primary function. If the 
module-name is specified on a SEQ command that immediately follows an ELE or COR statement, 
the module is sequenced as it is added or resequenced as it is corrected, respectively. 





If omitted: 


2 and the SEQ control statement immediately follows an ELE control statement, the SEQ control 
statement checks the sequence of a program source or macro/jproc module being filed; or 


VT] and the SEQ control statement immediately follows a COR control statement, the SEQ control 
statement identifies a sequence field that is in the program source or macro/jproc module being 
corrected and that is used to insert corrections. 


column-position 
First column position in the program source or macro/jproc record where the sequence field 
begins and where the sequence data is incorporated. 


If omitted, column 73 is assumed to be the first column of the sequence field. 


® content 


A 1- to 8-character value specifying the initial value placed into the sequence field of the first 
record in the module. The length of this value determines the length of the sequence field. The 
rightmost portion of the sequence field must be removed. The mixing of sequence numbers with 
alphabetic and numeric characters is permitted, provided that the alphabetic and numeric string 
remain intact and the alphabetic characters are left-justified. 


SAME 
Contents of the sequence field of the first record of the module being resequenced are to remain 
as they were. This specification assumes that this field occupies eight character positions. If it 
does not, this parameter should not be specified. Instead, the initial sequence field content 
should be respecified. 


If omitted, the initial sequence contents are assumed to be OOOOOOO0O. 
increment 
A decimal number, not to exceed 255, that specifies the sequence increment used in the 


sequencing process. 


If omitted, the increment is assumed to be 1. 
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SKI 


Function: 


Used only with the COR control statement to correct program source or macro/jproc modules. The 
SKI statement allows one or more consecutive original records in a program source or macro/jproc 
module to be skipped by the COR function. Record sequence numbers are used to identify the first 


and last record to be skipped. 


Format: 






AOPERATIONA OPERAND SEQUENCE 







Cstarting- 
sequence-no.] 


SKI[.options]] last-sequence-no. 





Options: 
D ____List the records skipped. 
Parameters: 
last-sequence-no 
One to eight alphanumeric characters identifying the sequence number of the last record to be 
bypassed. 
starting-sequence-no 
One to eight alphanumeric characters identifying the sequence number of the first record to be 


bypassed. This field begins in column 73 unless an SEQ control statement dictates otherwise. 


If omitted, the skip begins immediately, starting with the record immediately following the last record 
operated on by the COR function. 














& 








3. MIRAM Librarian (MLIB) Control Statements 
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CHG 


Function: 
Used to change the name of an existing screen format (F-type) module or saved run library (J-type) 
module or used to insert comments on the header record. Only one change operation per command 
can be performed. 

Format: 


LABEL 


unused 


AOPERATIONA OPERAND 


input-lfn, {module- type} a 










N,nNew-name | 
C,'comments' 





Parameters: 


input-lfn 
Specifies the file number (as defined by the FIL statement) of the file to be used as input. Also, 
the updated header record will be written to this file. 


module- type 
Specifies the type of module being processed as either a screen format module (F) or (FC), a 
saved run library module (J), a help screen module (HELP), or a menu module (MENU). No default 
is allowed. 


old-name 
Specifies the name of the module being processed. No default is allowed. 


N, C 
Specifies the type of change being performed as either a name change (N) or a comment insert 
(C). No default is allowed. 


new-name, comments 
Specifies the information required by the type of change parameter. If N was specified, a valid 
module name must be specified. If a module with the same name and type already exists in the 
file, an error will result and the change will not occur. If C was specified, a comment (up to 30 
characers) enclosed by single quotes must be specified. 
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COP 


Function: 


Used to copy the nondeleted contents of an entire library file to another library file, creating a 
compressed output file, or to copy from one file to another individual modules based on module 
names or types or on module name prefixes. 


Format: 

LABEL AOPERATIONA OPERAND 

unused COP[.options]} input-lfn{,{module-type})[,name],output-lfn 
Options: 


C Specifies that the name specified in the name parameter is a module name prefix. 
Parameters: 


input-lfn 
Specifies the file number (as defined by the FIL statement) of the file to be used as input. 


module-type 
Specifies the type of modules being copied as either screen format modules (F) or (FC), a saved 
run library module (J), a help screen module (HELP), or a menu module (MENU). If no type is 
specified, all modules with the specified name are copied. 


name 
Specifies the name or prefix (up to eight characters) of the module. If no name is specified, all 
modules of the specified type (F or J) are copied. 

output-lfn 
Specifies the file number (as defined by the FIL statement) of the file to be used as output. No 
default is allowed. 


NOTE: 


If the name and type specifications are both omitted, the entire file is copied. 
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@ DEL 





Function: 


Used to delete the active contents of an entire MIRAM library file or to delete individual modules 
based on prefixes, module names, and/or types. 





Format: 
LABEL AOPERATIONA OPERAND 
| 
| unused DEL[L.options]| input-lfn;[,{module-type}][,name] 
Options: 


Cc Indicates that the name specified in the name parameter is a module name prefix. 
Parameters: 


input-lfn 
Specifies the logical file name (as defined by the FIL statement) of the input file. 


@ module- type 


Specifies the type of modules being deleted as either screen format modules (F) or (FC), a saved 
run library module (J), a help screen module (HELP), or a menu module (MENU). If omitted, all 
modules with the specified name are deleted. 


name 
Specifies the name or prefix of the module being deleted. 


NOTE: 


If no type is specified, the module name must be specified or the entire file is deleted. 


UP-8842 Rev. 3 SPERRY OS/3 3-4 
SYSTEM SERVICE PROGRAMS 





FIL 





Function: 


Declares to the librarian all MIRAM files that will be referenced subsequently in the control stream. At 
the same time, each file is assigned a logical file number (O—29), which forms a logical file name that 
is to be used (rather than the filename) for all subsequent file references within the control stream. File 
declarations may be strung out on one FIL statement or be made individually on separate FIL 
statements. Up to 30 files can be declared in your control stream. 


Format: 






AOPERATIONA OPERAND 


unused Fn=filename-1[,...filename-n] 


Parameters: 


Fn=f ilename 
Specifies that the MIRAM file (filename) is equated with the logical file name (FO-F29), which 
forms a logical file name that is to be used for all subsequent file references within the control 


stream. & 


NOTE: 





The file name specification may not exceed eight alphanumeric characters and must begin with an 
alphabetic character. 
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PRT 


Function: 


Used to print modules or file directories. 





Format: 

LABEL AOPERATIONA OPERAND 

unused PRT[.options]] input-lfn [,{module-type}][,name] 
Options: 


Cc Indicates that the specified name is a prefix. 
D Indicates that a file directory is printed. If specified, the name parameter must be omitted. 
Parameters: 


input-lfn 
Specifies the file number (as defined by the FIL statement) of the input file. No default is allowed. 


module-type 
Specifies the type of modules being printed as either screen format modules (F) or (FC), a saved 
run library module (J), a help screen (HELP), or a menu module (MENU). If the D option is used 
and F is specified, screen format directory entries are printed. If the D option is used and J is 
specified, saved run library directory entries are printed. Whenever the D option is specified and 
the type is omitted, the entire directory is listed. If both the D option and type parameter are 
omitted, all modules of the specified name are printed. 


name 
Specifies the name or the prefix of the module to be printed. When you are using the D option, 
this parameter must be omitted. If the C option is used, the name is used as a prefix, and all 
modules of the specified type beginning with this prefix are printed. If this parameter is omitted, 
all modules of the specified type are printed. 


NOTE: 


If no options are specified and name and type are omitted, all modules in the specified file are printed. 














4. Linkage Editor Control Statements 



















UP-8842 Rev. 3 SPERRY OS/3 4-1 
SYSTEM SERVICE PROGRAMS 





® | ENTER 


Function: 


Provides the address of the entry point of the load module phase being built. This is the address to 
which control is normally transferred if the phase is loaded by a supervisor FETCH macroinstruction. 
The ENTER statement is usually the last control statement for a phase. It may be followed by a MOD, 
EQU, RES, or comment statement in addition to an OVERLAY statement for the next phase, a REGION 
statement for new region, a LOADM or LINKOP statement for a new load module, or an end-of-data 
(/*) statement, which ends execution of the linkage editor. 


If the ENTER control statement is immediately followed by an INCLUDE control statement, a diagnostic 
warning indicating the sequence error is listed on the link-edit map, but the INCLUDE control statement 
is processed and included in the current phase. 


If no ENTER statement is provided for a phase, the transfer address is obtained from the first object 
module transfer record in the phase that has a valid transfer address. If no object module supplies a 
valid transfer address, the entry point address is the relocated address assigned to the first CSECT 
specifically included in the phase. 


Format: 









AOPERATIONA OPERAND 


[expression] 
Parameter: 
expression 

Transfer address for the phase. This expression, which usually represents a relative phase 

address, may have one of the following forms: 

rT] A decimal number from one to eight digits long 

. A hexadecimal number from one to six digits long, in the form X‘nnnnnn’ 

a A previously defined label (the name of a control section or an entry point in an object 

module that was previously included or defined by a previous EQU statement). For the link 


edit of a nonreentrant module, this symbol must not be a shared definition. 


a A previously defined label plus or minus a decimal or hexadecimal number as previously 
described 


If omitted, the transfer address is that address assigned to the base (node point) of the phase. 
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EQU 


Function: 
Provides the linkage editor with the value of a label that would not otherwise be defined. The 
definition of a symbol by an EQU control statement is subject to the same rules for automatic deletion 


as entry points. 


Format: 









AOPERATIONA OPERAND 





symbol expression 
Label: 
symbol 
One to eight alphanumeric characters specifying the label to be defined. 
Parameter: 
expression 


Value to be assigned to the label. The expression may have one of the following forms: 
rT] A decimal number from 1 to 10 digits long 
a A hexadecimal number from one to eight digits long, in the form X‘nnnnnnnn’ 


= A previously defined label (the name of a control section or an entry point in an object 
module that was previously included or defined by a previous equate statement) 


a A previously defined label plus or minus a decimal or hexadecimal number, as previously 
described. For the link edit of a nonreentrant module, this label must not be a shared 


definition. 


a An asterisk (*) to indicate a reference to the current value of the location counter 
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@ INCLUDE 


Function: 


Requests that a specific object module or selected control sections of a specific object module be 
included in the current phase of the load module being built. This control statement may follow any 
linkage editor contro! statement except the ENTER control statement, or it may be embedded in an 
object module. Nesting of embedded INCLUDE control statements may continue indefinitely. Nested 
INCLUDE control statements are identical in format and capability to those not nested and may thus 
specify full or partial inclusion, as well as alternate files. The same applies during the automatic 
inclusion process, although the initial module located and used to satisfy reference always is included 
in full. 


If this control statement is omitted from an otherwise valid linkage editor control stream, all the object 
modules currently residing in the system job run library (SY$RUN) are included in the load module 


phase being built. 


Format: 


LABEL SOPERATIONA OPERAND 





INCLUDE [module-name][,(s1,...s9)][,filename] 


Parameters: 


module-name 
One to eight alphanumeric characters identifying the object module to be included. 


If omitted, it is assumed that the INCLUDE control statement is nested and that the object module 
being referenced immediately follows the previously referenced object module in the library being 
accessed. Otherwise, an error message is output on the link-edit map. 


s1 through s9 
Is a list of One to nine control section labels that identify the CSECTs to be included in the 
load module phase being built. The control sections referenced in these subparameters 
must be contained in the object module referenced by the INCLUDE control statement; 
otherwise, an error diagnostic is output on the link-edit map. The order in which the 
CSECTs appear in the object module is the order in which they will appear in the load 
module, regardless of the order in which they are listed in these subparameters. 


When a subparameter list is specified, no unnamed CSECT in the module being scanned is 
ever included in the load module, but all requests for common storage are honored, as are 
all embedded control statements. 


If omitted, the entire object module referenced is included in the load module except for those 
CSECTs that may be automatically deleted by the linkage editor. 
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INCLUDE 





filename 
One to eight alphanumeric characters identifying the symbolic name of the file in which the 
referenced object module is stored. This name must be specified exactly as it is specified in the 
job control label file directive (LFD) that identified the file; otherwise, an error message is output 
on the link-edit map. 


if omitted, the object module is assumed to be in $Y$RUN or, if not there, in the last library specified 
in an INCLUDE contro! statement or, if not there and a file name was specified in a previous // 
PARAM statement, in the file specified in the // PARAM statement; otherwise, the object module is 
assumed to be in the system object library file (SYSOBJ). 
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& LINKOP 


Function: 


Specifies the options to be used in creating the load module. This control statement may appear only 

| within the linkage editor control stream, within the data definition, and must not be specified in the job 
control stream proper. The first LINKOP control statement processed for a job establishes the initial 
linkage editor options for that job. These options take effect as soon as they are detected and remain 
in effect until changed by a succeeding LINKOP control statement or until the job is ended. This 
applies to system-supplied (default) parameter specifications, as well as programmer-supplied 
specifications. (Once a default specification is overridden by the programmer, the programmer-supplied 
specification remains in effect for the remainder of the job or until it is explicitly respecified by another 
LINKOP control statement.) 


The linkage editor starts the building of a new load module each time it processes a LINKOP control 
statement. Conflicting specifications are resolved by assuming that the last statement specified is 


correct and the linkage editor functions accordingly. 


If linkage editor options are not specified in the control stream for a given job, the linkage editor 
functions under the direction of the default parameter specifications as follows: 


1. Performs automatic inclusion of required object modules, as necessary, and assumes that 
@ $YS$OBJ is the only file that might contain the required modules 


2. Processes V-CON references, as required 
3. Stores the output load modules in $Y$RUN 


4. Uses only the control statements contained in the primary control stream to produce load 
modules 


5. Generates phase header records that contain blank comment fields and does not require the 
system loader to clear main storage before the phase is loaded 


6. Processes all the control statements contained in the control stream, even if processing errors 
that would render a load module useless are detected 


7. Provides for the promotion of common storage areas 


8. Generates a link-edit map for each module generated that lists all the information normally 
desired in the link-edit map 


9. Produces nonreentrant load modules 


10. Recognizes reentrant object modules and creates the shared records needed to link their load 
module counterparts with the load module being created 


11. Creates internal symbol dictionary (ISD) records in the load module. At execution time, these 
& records enable JOBDUMP to print a formatted dump of the ijoad module area. 
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LINKOP 
Format: 
LABEL AOPERATIONA OPERAND 
LINKOP CALIB=filename] 
{,CLIB=modul ename/ filename] 
Ca eae 
,OUT= {filename 
(N) 
tae ffi venaaal 
 trocne! | {roznet| 
Feil sown Hag 
As NOCNTCD ie lan |) 
ee pe Me | 
eee is 7 
{ fam ee few 
ORE eee NORNT 
ier 
NOISD 
NOTES: 


1. System-supplied parameters are in effect only until changed by the user. Once changed, they 
must be reset to their default state by the user before the default option is effected again. 


2. Keywords may be specified in any order but must be separated by commas, with no spaces 
between the keywords unless they identify a delimited character string. 


3. Private file names declared are always logical and must be accompanied by the appropriate job 
control DVC/LFD statements. 
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LINKOP 


Parameters: 


ALIB=filename 
File to be searched during automatic inclusion processing. 


If omitted, only the RLIB-specified file is searched during the automatic inclusion process. 


CLIB=modul ename/ filename 
Name of a source module, and the file in which it resides, that contains the linkage editor control 
statements to be processed for this link-edit job. 


If omitted, the current control stream source (primary input or source module input) continues to be 
accessed for control statements. 


CMT='character-string' 
A character string of up to 30 characters to be inserted in the comment field of each phase 
header record produced for the generated load modules. The character string must be enclosed 
in apostrophes and may contain blanks, commas, and other special symbols. Phase header 
comment fields are listed in the allocation map portion of the link-edit map. 





Phase header comment fields are to be blank. 


If omitted, the phase header comment fields are left blank unless a previous CMT keyword specified 
otherwise. 


OUT=filename 
Library file name in which the output load module is to be stored. If a load module with the same 
name already exists in the output file specified by this keyword, it is replaced by the new load 
module. 


OUT=(N) 
Output load modules produced by the linkage editor are not to be stored in any library file; 
however, the link-edit map is still produced if not inhibited by specification of the NOLIST 
keyword parameter. 





Output load modules produced by the linkage editor are stored in $Y$RUN. 


if omitted, the load modules produced are output to $Y$RUN unless a previous OUT keyword 
specified otherwise. 


NOTE: 


The file designated to store the output of the linkage editor is logically extended to accommodate the 
load modules produced by the linkage editor. 
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LINKOP 





RLIB=f ilename 
Identifies the file to be searched by the linkage editor, under the following conditions. 


|] During the automatic inclusion process, when no automatic include library file (ALIB) has 
been specified (no previous ALIB keyword specification present) or when the specified ALIB 


does not contain the required module. 


a During the specific inclusion process, when no file name is specified on an INCLUDE control 
statement and: 


— the module is not found in $Y$SRUN; or 


-— the module is not found in the file last specified on a prior INCLUDE control statement 
or no prior INCLUDE control statements exist. 





File to search under the conditions just described. 


If omitted, $Y$OBJ is searched under the foregoing conditions, unless a previous RLIB keyword 
specified otherwise. 





CNL 


Cancel link-edit job step at the end of the link-edit operation for the current load module if any 
diagnostic processing has been triggered during the generation of the load module; otherwise, 
processing continues, regardless of the number or type of error diagnostics triggered, until the 
normal end-of-job function for the link-edit job step is detected. 





Process link-edit job step to completion, regardless of the number or type of diagnostic errors 
detected. 


If omitted, NOCNL is assumed unless the CNL keyword was previously specified. 


ZRO 


Clear main storage to all O’s prior to loading each phase of the load module. 





Do not clear main storage to O’s before each phase of the load module is loaded. 


If omitted, NOZRO is assumed unless the ZRO keyword was previously specified. 





Automatic inclusion processing is performed for the load modules being built. 


NOAUTO 
Automatic inclusion processing is not performed for the load modules being built. 





If omitted, AUTO is assumed unless the NOAUTO keyword was previously specified. 
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LINKOP 


NOTE: 


The NOAUTO specification does not affect the automatic inclusion of the overlay control routine if 
V-CON processing is not inhibited (NOV keyword not specified) and valid V-CON references exist in 
the object code being included in the load modules being produced. 


Specifies that V-CON references are permitted to appear in the object module elements to be 
included in the load modules and that automatic loading of required phases is started. 


NOV 
Specifies that V-CON references are treated as A-CON references and that automatic loading of 
phases is inhibited because it is not required. This specification is significant only when valid 
V-CON references are present in the object module elements being included. 


If omitted, V is assumed unless the NOV keyword was previously specified. 





Place common storage areas in their most efficient phases within the load module being buiit. 


NOPROM , 
Place all common storage areas in the root phase of the load module being built. 


If omitted, PROM is assumed unless the NOPROM keyword was previously specified. 





Produce standard link-edit map for current link-edit job. 


NOLIST 
Do not produce standard link-edit map for current link-edit job. 


If omitted, LIST is assumed unless NOLIST was previously specified. 





Produce process map portion of the link-edit map. 


NOCNTCD 
Suppress process map. 


If omitted, CNTCD is assumed unless NOCNTCD was previously specified. 





Link-edit map includes diagnostic messages and unresolved references. 


NOERR 
Suppress this information. 


If omitted, ERR is assumed unless NOERR was previously specified. 
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LINKOP 








Produce definitions dictionary and phase structure diagram portions of the link-edit map. 


NODICT 
Suppress definitions dictionary and phase structure diagram portions of the link-edit map. 


If omitted, DICT is assumed unless NODICT was previously specified. 





List CSECT, COM, and ENTRY items in the allocation map portion of the link-edit map. These 
ESDs are associated with their respective object module origin and ESID, length, linked base 
address, and high limit after linking. 


NODEF 
Suppress ESDs. 


If omitted, DEF is assumed unless NODEF was previously specified. 





List phase data (phase name, alias name, origin, length, transfer address, etc) in allocation map 
portion of the link-edit map. 





NOPHS 
Suppress phase data. 


If omitted, PHS is assumed unless NOPHS was previously specified. 


DEL 


List all definitions, including those automatically deleted due to redundant inclusions on identical 
paths or items not included because of partial include specifications, on the allocation map, so 
long as definitions are being listed (NODEF is not specified). 





Automatically deleted definitions are not listed. 


If omitted, NODEL is assumed unless DEL was previously specified. 


RCNTCD 


List control statements that are to be included in the allocation map portion of the link-edit map 
so that each may be located easily to see its effect on the load module. Only action-type control 
statements are included in the allocation map; // PARAM and LINKOP statements are never 
listed. 





No listing of control statements in the allocation map. 


If omitted, NORCNTCD is assumed unless RCNTCD was previously specified. 
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LINKOP 


REF 
List in the allocation map portion of the link-edit map all references (EXTRNs) and transfer 
records processed, the object module assigned address and ESID, and the resolved value, if 
appropriate. 


Suppress this information. 





lf omitted, NOREF is assumed unless REF was previously specified. 


Specifies that object modules marked reentrant are to be recognized during the inclusion process 
(specific and automatic). The text from such modules is not to be included. Instead, shared 
records are to be created for references made to reentrant code. The load module produced is 
nonreentrant but may contain references to reentrant code. This parameter is ignored if a 
reentrant load module is being generated (the RNT parameter is specified). 


NOSHARE 
Specifies that all object modules are to be treated as nonreentrant and no shared records are to 
be generated. A nonreentrant load module is produced that contains no references to shared 
code. 


If omitted, SHARE is assumed unless NOSHARE was previously specified. 


RNT 


Specifies that a reentrant load module is to be produced and SENTRY records are to be 
generated. Normally, only one object module would be included in the link-edit, in which case, 
the load module name must be the same as object module name. Parameter NOAUTO should be 
specified when using this option. 





Specifies that a nonreentrant load module is to be produced though references may be made to 
reentrant code. 


If omitted, NORNT is assumed unless RNT was previously specified. 





Specifies that type 3 and type 4 ISD records from the included object module are relocated and 
passed to the load module. It also specifies that type 1 and type 2 ISD records are generated 
based on the undeleted CSECTs and COMMONSs detected during the link-edit. If execution of the 
load module terminates, these records are used by JOBDUMP (if specified) to print a formatted 
dump, segmenting it by CSECTs and printing user program symbols. 


NOISD 
Specifies that ISD record generation is to be suppressed. 


If omitted, ISD is assumed unless NOISD was previously specified. 
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LOADM 


Function: 


Specifies the program name for the module being built. The LOADM control statement may follow 
only a // PARAM, LINKOP, or comment statement or a complete set of control statements when used 
in a control stream that is generating more than one load module. 


If this statement is omitted from an otherwise valid linkage editor control stream and no LOADM 
control statement is embedded in an included object module, the load module produced by the linkage 
editor is assigned the name LNKLOD by default. 


Format: 


LABEL AOPERATIONA OPERAND 





Parameter: 


name 
One to six (eight, if a reentrant load module is being created) alphanumeric characters specifying 
the name to be assigned to the load module. The first character must be alphabetic. If the 
specified name is less than six or eight characters, as applicable, it is padded on the right with 
EBCDIC O's. If the specified name is more than six characters (eight, if it is the link-edit of a 
reentrant module), it is truncated to the maximum allowable limit. 


If omitted, the default name LNKLOD is assumed to the load module. 
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@ MOD 


Function: 


Tells the linkage editor to modify its location counter to agree with a specific power of 2 and a 
specific remainder. 


Format: 





LABEL AOPERATIONA OPERAND 











remainder 


power ' i 


Parameters: 


power 
A decimal number specifying the power of 2 relative to which the location counter is to be 
adjusted. The only acceptable powers of 2 that may be specified are 8, 16, 32, 64, 128, 256, 
512, 1024, 2048, 4096, 8192, 16384, and 32768. 


g remainder 
A decimal number that is a multiple of 4 and specifies the desired remainder of the new value of 
the location counter relative to the specified power of 2. If the decimal number specified is not a 
multiple of 4, it is rounded to the next higher multiple of 4, then truncated to a value less than 
the specified power of 2. 


lf omitted, the remainder is assumed to be 0. 
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OVERLAY 


Function: 


Identifies the beginning of an overlay phase (a phase other than the root phase) and defines the 
relative position of the phase within the load module structure. The object modules included thereafter 
establish a single, separate phase until the next OVERLAY, REGION, LOADM, LINKOP, or end-of-data 


(/*) control statement is detected. 


This statement cannot be used in the link edit of a reentrant module. 


Format: 
LABEL AOPERATIONA OPERAND 
OVERLAY symbol[,alias-phasename)} 
Parameters: 
symbol 


Name of a logical or relative node point that defines the starting address (but not necessarily the 
entry point) of the phase. It may consist of one to eight alphanumeric characters. If the symbol is 
relative (a CSECT, ENTRY, or EQU name), it must be on the path of the phase. Further, the 
relative symbol must not be a shared definition. 





alias-phasename 
A 1- to  6-character, user-supplied phase name that can be used _ in 


linkage-editor-supplied phase name to address the phase being created by the OVERLAY control 
statement. If an alias phase name longer than six characters is supplied, it is truncated to six 


place of 


characters. 
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PARAM 


Function: 


Specifies the initial linkage editor options that are to be in effect during the building of a load module. 
Performs the same function as the LINKOP control statement but can only be specified in the job 
control stream proper, not within the linkage editor data set. It can only be used to define the initial 
options and may not be used to change or add to those options within a linkage editor job step. 


Format: 


// PARAM Same keyword parameters as those specified for the 
LINKOP control statement 
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REGION 





Function: 


Begins building the first phase in a new region, starting at the end of the longest path currently built 
for the load module. Once a region has been started, no prior region structure may be continued. All 
parts of a given region should be fully specified and built before beginning a new region. The only 
phase common to all regions in a load module is the root phase. 


OVERLAY control statements may be interspersed among REGION control statements to structure the 
phases within each region. The first phase of any region, including the initial phase, may be overlaid 
by referencing the region node (or LOADM node) or a symbol with that address, using an OVERLAY 
contro! statement. Inasmuch as the REGION control statement effectively replaces an OVERLAY, 
INCLUDE and other control statements used for the building of a phase follow immediately. Up to 10 
regions may be declared for a single load module. 


Format: 





AOPERATIONA OPERAND 











REGION symbol[,alias-phasename] 





Parameters: 


Refer to parameter description for the OVERLAY control statement. Note that inasmuch as the implied 
origin of a new region always is at the end of the longest path of the current region, a symbol in a 
REGION control statement may specify only a logical node name and not a relative definition name, as 
in the case of an OVERLAY control statement. 
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RES 


Function: 


Tells the linkage editor to reserve additional space in main storage following the end of the longest 
path in the highest region of the load module. The additional storage requested by this statement adds 
to the total length of the module and is recorded in each phase header record, but is not included in 
the size requirements for any particular phase. This statement, therefore, may be placed anywhere 
within the control stream for a load module. 


Processing this control statement, the linkage editor automatically assigns two entry points to the 
reserve storage area. These entry points may be addressed by the user to access the reserve storage 
area by declaring them as EXTRAS in your program. The two entry points assigned are: 


1. KES$ALP — effective address of the end of the longest path in the load module, or the starting 
address of the reserve storage area. 


2. KESRES — effective address of the end of the longest path plus the sum of all the reserve 
storage area size specifications (RES control statements) or the address of the last four bytes 
(one word) of the reserve storage area. 


These two entry points cannot be used in the operand field of the EQU contro! statement. 


Format: 
LABEL AOPERATIONA OPERAND 
RES value 
Parameter: 
value 


Specifies, in one of the following forms, the number of bytes of storage to be reserved. 
a A decimal number from 1 to 10 digits long 


a A hexadecimal number from 1 to 8 digits long, in the form X‘nnnnnnnn‘ 











5. Initialize Disk (Disk Prep) Routine (DSKPRP) 
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INSERT 


Function: 


Identifies the address of the track suspected of being defective. Track addresses can be specified in 
individual INSERT control statements or listed on one INSERT control statement up to column 71. 
These control statements must follow the VOL1 statement in the control stream and be used 
whenever the keyword INSRT=X or INSRT=Y has been specified. 


Format: 


1 10 71 
INSERT ceccchh[,cccchh...,cccchh] 

cecchhrr [,cccchhrr...,cccchhrr] (for 8494 only) 

NONE 


Parameters: 


cccchh 
Six hexadecimal numbers indicating the cylinder (cccc) and head (hh) address of a possible 
defective track. 


eccchhrr 
Eight hexadecimal numbers indicating the cylinder (cccc), head (hh), and record (rr) address of a 
possible defective record. This format applies to 8494 disks only. 


NONE 
No defective tracks are known to exist on the disk. 





UP-8842 Rev. 3 SPERRY OS/3 5-2 , ; 
SYSTEM SERVICE PROGRAMS 





VOL1 


Function: 


Creates the standard volume labels (VOL1) on the disk pack or initializes the data set labels or format 
labels on a diskette. 


Format: 
4 11 42 51 72 
VOL1 (r] [aaaaaaaaaa] 
Parameters: 
r 
This entry is reserved for future use. 
aaaaaaaaaa 
Alphanumeric name and address of the owner. If RPVOL=Y specified, specifies new owner 
name and address. 
NOTE: 





VOL 1 is the only entry required for initializing diskettes. 
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KEYWORD PARAMETERS FOR DISK 
Function: 


There are 18 keyword parameters that supply the needed information for disk prepping. When 
prepping a disk, always specify the SERNR keyword parameter. 


Format: 


¥% (for model 8-20 | 


eet 








,PREPT= ,PTEND={ cccchh 
019306 (for 8416 only) 
019312 (for 8430 only) 
(for 8417 only) 
02701F (for 8470 only) 
2 ' (for 8418/19 only) 
032712 (for 8433 only) 
(for 8417 fixed head) 


027113 (for 8494 only) 















, SERNR=volume-serial-number (six characters) 








, TRCON=(8 ,TRKCT=/B (for 8417 only) FRMTG=D (for 8470 only) 
N D 
K(for 8417 L 
only) Er, 








K (for 8417 only) 
eas Y 


enh ,VTOCB=(cccchh 
x Y @GCAGE for IPL volumes 


yes ' for non-IPL volumes 
ans cecchh 
@OCAnn (for IPL volumes) 





ssi (for non-IPL volumes) 


<_ 


4 
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ALTRK 
ILOPT 
INSRT 





ALTRK Keyword Parameter: 


Specifies whether the alternate track area of the disk is to be tested. 


ALTRK=N 
Track area is not tested. 





ALTRK3¥ 
Track area is tested. (ALTRK=Y is not supported for 8494 disks since there are no alternate 
tracks.) 


ILOPT Keyword Parameter: 


Specifies whether initial microprogram load is to be written to disk. 





- Specifies that initial microprogram load is to be written to disk. Automatic default on model 
8 systems whenever IPLDK=Y is specified or defaulted. 





‘ Specifies that initial microprogram load is not to be written to disk. Must not be specified 
or defaulted when IPLDK=Y on model 8-20 systems. 





INSRT Keyword Parameter: 


Indicates if specific tracks (as identified by INSERT control statements) are to be tested for defects. 





No INSERT control statements appear in the control stream. 


INSRT=X 
Only INSERT contro] statements are used to designate defective tracks. 


INSRT=Y 


INSERT control statements are used together with the normal surface analysis function to 
flag defective tracks. 
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IPLDK 
PARTL 
PREPT 


IPLDK Keyword Parameter: 
Indicates if disk being prepped is to be used for an IPL volume. 


IPLDK=N 
Disk is not an IPL volume. 


IPLDK=¥ 
Disk is an IPL volume. 


PARTL Keyword Parameter: 


Indicates only a partial prep is being done or indicates changing your volume serial number while also 
removing all entries in the VTOC of your disk. 


PARTL=& 
Indicates no partial prep or change in the volume serial number. 


PARTL=S 


Indicates a partial prep used with the PTBEG and PTEND keyword parameters. The prep is done 
under this option without regard to VTOC, labels, or files. 


PARTL=V 
Indicates a change in the volume serial number and VTOC (with or without COS). 


PREPT Keyword Parameter: 
Specifies the extent of surface analysis you want disk prep to perform. 


PREPT=1 
One pattern written and verified. 


PREPT=2 
Two prep patterns written and verified. 


Pabena 
C 
Three patterns written and verified (most in-depth and accurate analysis). 


PREPT=§ 
Fast prep. Read only (minimum analysis). 
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PTBEG 
PTEND 
RETRY 
RPVOL 


PTBEG Keyword Parameter: 
PTBEG=cccchh 
Six hexadecimal characters representing the primary track address at which disk prepping is to 
start. 
If omitted, 000000 is assumed. 
PTEND Keyword Parameter: 
PTEND=cccchh 
Six hexadecimal characters representing the primary track address at which disk prepping is to 
end. It must be equal to or greater than the starting address. 
If omitted, the ending track address defaults to that shown for individual disk types. 


RETRY Keyword Parameter: 


Indicates the number of times an I/O command is to be reissued during surface analysis testing when 
errors are encountered. May also be used with PREPT =F. 


RETRY=nn 
Two hexadecimal numbers specifying the number of retries to be made during surface analysis 
testing. 

If omitted, hexadecimal OA (10 retries) is assumed. 


RPVOL Keyword Parameter: 


Indicates if the disk pack or diskette volume serial number is to be changed in the VOL1 label. The file 
information and file serial number of the files currently in the VTOC are not changed. 


RPVOL=#% 
Volume serial number is not to be changed. 


RPVOL=Y 
Volume serial number or user address is to be changed. 
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SERNR 
TRCON 
TRKCT 


SERNR Keyword Parameter: 


SERNR=volume-ser ial -number 
Six alphanumeric characters representing the disk pack or diskette number. This number may 
already have been assigned to the disk or diskette volume or may specify a new assignment. No 
embedded blanks are permitted. 


TRCON Keyword Parameter: 


Indicates the processing method used by DSKPRP routine for the track condition table (TCT) or, for 
8494 disks, the sector condition table (SCT) and, when applicable, the defect skip table (DST). 


TRCON=D 
Disk method. Used when the disk has been in use (previously prepped) and the current 
track/sector assignments are to be retained. Existing TCT/SCT must be updated and used to 
create new TCT/SCT. 


TRCON=N 
Surface analysis method. Used when the disk is being prepped for the first time, or the 
TCT/SCT cannot be recovered by using TRCON=D. The N option indicates that the disk is 
formatted, and a new TCT/SCT is built. 


NOTE: 
For 8470 disks, specify TRCON=N and FRMTG=D to rewrite home addresses. 


TRCON=K 
Defect skip method. Used when prepping 8417 disks. Indicates that the disk is to be completely 
reformatted with defect skipping. The track condition table and the defect skip table are input 
from diskette. 


TRKCT Keyword Parameter: 
Specifies if the TCT/SCT is to be printed, written to disk, or written to diskette. 


TRKCT=B 
Output to diskette and printer. Used only for 8417 disk packs. No other prepping functions take 
place. Useful to back up DST without prepping disk pack. Disk must have been previously 
prepped. 


TRKCT=D 
Output TCT/SCT to disk. 


TRKCT=L 
Output to printer and no other prepping functions take place. Disk must have been previously 
prepped. Useful for future references about disk track condition. 


TRKCT=Z 
Output to disk and printer. 


TRKCT=K 
Output to disk, diskette, and listed on the printer. Used only when prepping 8417 disk packs. 
Recommended for backing up your DST. 
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FRMTG 
UNXFC 
VERFY 

VTOCB 





FRMTG Keyword Parameter: 


Rewrites home addresses for 8470 disks. 


FRMTG=D 
Must be specified with TRCON=N. 


UNXFC Keyword Parameter: 


Checks the expiration date for all files on the volume. DSKPRP compares the system date to the 
expiration date. If the expiration date is not expired, a message is displayed asking either to cancel the 
prep or to ignore the date and continue the prep. 


UNXFC=Y 
Expiration date is checked. 


UNXF C= 
Expiration date is not checked. 





VERFY Keyword Parameter: 


Assures that the area to be prepped as specified by keywords PTBEG and PTEND is free of data (not 
already in use). This option can only be used on a pack previously prepped and used by OS/3. When 
using this option, specify PTBEG, PTEND, and SERNR; TRCON cannot be N, and TRKCT cannot be P. 
The following is automatic: ALTRK=N. The following are ignored: VTOCB, VTOCE, ILOPT, and IPLDK; 
they are, however, syntax checked. The keywords INSRT and PREPT may be used as desired. The 


VOL1 card must also be included in the deck. 


VERF Y= 
Area is not tested. 


VERFY=Y 
Area is to be tested. 


VTOCB Keyword Parameter: 


Six hexadecimal numbers representing the primary track address at which the VTOC starts. It must be 
less than the ending VTOC address. 


for IPL volumes 


VTOCB=( cccchh 
for non-IPL a 
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VTOCE 


VTOCE Keyword Parameter: 
Six hexadecimal numbers representing the primary track address at. which the VTOC ends. 


VTOCE=( cccchh 

for 8417 IPL volumes 

for 8417 non-IPL volumes 

for 8416, 8418, and 8419 IPL volumes 
» for 8416, 8418, and 8419 non-IPL volumes 
@OCA12 for 8430 and 8433 IPL volumes 

000012 for 8430 and 8433 non-IPL volumes 
@OCA1F for 8476 IPL volumes 

Q99001F for 8470 non-IPL volumes 

@0CA13 for 8494 IPL volumes 

000013 for 8494 non-IPL volumes 








e 


6. 





Initialize Diskette Routine (DSKPRP) 
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KEYWORD PARAMETERS FOR DISKETTE 


Function: 


There are 14 keyword parameters that supply the needed information for diskette prepping. When 
prepping a diskette, the SERNR keyword parameter, as well as the VOL1 statement, must always be 
specified. Diskette prep is a function of the DSKPRP routine. 


Format: 





[, CUADR=nnn) : a | [ els \] i ga ta f norrsta] 


, IMPNM={¢ 
DBUS (models 3-6 only) 
FDD® (models 8-2@ only) 





IDC (models 3-6 only) 


‘ (models 8-20 only) 
IOMP (models 3-6 only) 


, IPLDK{Y fall LACEG{nn)][, PARTL x] ,RECSZ(: 
ait|| (a fea 


512 


bata oy aa ceca cca , UNXFC=/Y 


ee fie 








| for 8420/8422 IPL and non-IPL sclines} | 





,VTOCE= — 
8% for 8420/8422 IPL and non-IPL volumes 





4 
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CUADR 
DNSTY 
FDATA 
FORMT 
ILOPT 


CUADR Keyword Parameter: 
CUADR=nnn. 


Specifies the control unit address of the IDCU disks. Must be devcie number O on the control 
unit (e.g., 420, 4A0, 510). Not required when IMPNM=FDDO. Ignored except for syntax 


checking on models 3-6. 
DNSTY Keyword Parameter: 
Specifies the density at which the diskette is to be prepped. 


DNSTY=% 
Specifies the diskette is single density. 


DNSTY=2 
Specifies the diskette is double density. 


FDATA Keyword Parameter: 


Specifies whether to automatically allocate the entire data set label diskette as one file (named DATA) 
or to have the files allocated via // EXT job control statement or ALLOCATE command. 





Specifies that the entire diskette is automatically allocated as one file. 


FDATA=N 
Specifies that the diskette is to be allocated by user. 


NOTE: 
{ The FDATA parameter is not applicable with format label diskettes. 


FORMT Keyword Parameter: 


Specifies the format at which the diskette is to be prepped. 





Specifies that the diskette is to be in data set label format. 


FORMT=FLB 
Specifies that the diskette is to be in format label format. 


ILOPT Keyword Parameter: 


Specifies whether initial microprogram load is to be written to diskette. 
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ILOPT 
IMPNM 
IPLDK 


ILOPT=Y 
Specifies that initial microprogram load is to be written to diskette. 


ILOPT=& 
Specifies that initial microprogram load is not to be written to diskette. 


IMPNM Keyword Parameter: 
Specifies the name of the IMPL module type written to diskette. 
IMPNM=CPU . 
CPU microcode written. Default specification for model 3-6 systems. Not applicable to model 


8-20 systems. 


IMPNM=DBUS 
DBUS microcode written. Applicable to model 3-6 systems only. 


IMPNM=IDC 
IDC microcode written. Applicable to model 3-6 systems only. 


IMPNM=IDCU 
IDCU microcode written. Default specification for model 8-20 systems. Not applicable to model 
3-6 systems. 


IMPNM=IOMP 
IOMP microcode written. Applicable to model 3—6 systems only. 


IMPNM=FDD®@ 
FDDO microcode written. Applicable only to model 8—20 systems. 


When IMPNM is specified, you must also specify ILOPT=V and provide the device assignment set for 
the $Y$SDF file; the name of the microcode must be in the $Y$SDF file. 


IPLDK Keyword Parameter: 
Indicates if diskette being prepped is to be used as an IPL volume. 


IPLDK=Y 
Diskette is an IPL volume. 


IPLDK=& 
Diskette is not an IPL volume. 


~ 


~<~ 
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LACEG 
PARTL 
RECSZ 
RPVOL 
SERNR 


LACEG Keyword Parameter: 
LACEG=nn 
Specifies the number of physical records on a track (01-25) that are to be offset between logical 
records. The default is 01. 
PARTL Keyword Parameter: 
Specifies the type of prep and whether a new volume serial number is written. 
PARTL=V 
Specifies a fast prep. Also, if the serial number specified in the SERNR keyword parameter is 


different from the one in the VOL 1 label, the specified serial number is written. 


PARTL=& 
Specifies a complete prep (slow), and the serial number remains the same. 


RECSZ Keyword Parameter: 


Specifies the size of the record to be created on diskette. 





RECSZ=4 
Record size is 128 bytes. 


RECSZ=256 
Record size is 256 bytes. 


RECSZ=512 
Record size is 512 bytes. 


RPVOL Keyword Parameter: 


Indicates whether the diskette volume serial number is to be changed in the VOL1 label. The file 
information and the file serial number of the files currently in the VTOC are not changed. 


RPVOL=#% 
Volume serial number is not to be changed. 


RPVOL=Y 
Volume serial number is to be changed. 


SERNR Keyword Parameter: 
Six alphanumeric characters representing the diskette number. This number may have already been 


assigned to the diskette volume, or may specify a new assignment. No embedded blanks are 
permitted. 











UP-8842 Rev. 3 SPERRY OS/3 6-5 
SYSTEM SERVICE PROGRAMS 


@ SPIRL 


UNXFC 


SPIRL Keyword Parameter: 


Specifies whether the spiraling technique of numbering records is to be used. 


SPIRL=Y 
Specifies that spiraling is to be used. 


SPIRL=8. 
Specifies that spiraling is not to be used. 


UNXFC Keyword Parameter: 


Specifies whether file expiration date checking is to be performed. 


UNXFC=Y 
Specifies that file expiration date checking is to be used. 


UNXF C= 
Specifies that file expiration date checking is not to be used. 
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VTOCB 
VTOCE 





VTOCB Keyword Parameter: 


Six hexadecimal numbers indicating the primary track address (in cylinder and head format) at which 
the VTOC starts. It must be less than the ending VTOC address and must be at least one track in 
length. 


VTOCB={cccchh 
4 @ for 8420/8422 IPL and non ctetsvelints} 





VTOCE Keyword Parameter: 


Six hexadecimal numbers indicating the primary track address (in cylinder and head format) at which 
the VTOC ends. 


VTOCE={cccchh 
for 8420/8422 IPL and non-IPL volumes 
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& DISK PREP JOB CONTROL REQUIREMENTS 


The following depicts the job control requirements for DSKPRP showing the location of optional cards in the 
job stream.: 


// JOB jobname 

// DVC number // LFD PRNTR 

// DVC number // VOL vsn // LFD DISKIN 

// EXEC DSKPRP 

/$ (keyword option cards inserted here) 

VOL1 
(track condition cards inserted here, if needed) 
CINSERT cards inserted here, if needed) 


/* 
/$ 
CIL(COS) cards inserted here, if needed) 
/* 
/& 
// FIN 


lf the TCT is being input from or output to diskette, the following statement must be added: 


// DVC number // VOL vsn // LFD DSKET. 


If IMPL is written to disk or diskette, the following device assignment set for the SYSRES volume must be 
included in the prep control stream: 


// DVC RES // LBL $Y$SDF // LFD $YSSDF 

















@ 7. Assign Alternate Track Routine (DSKPRP) 
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KEYWORD PARAMETERS 


Function: 


These are five keyword parameters that supply the information needed for assigning an alternate 
track/sector. The ASGTK and SERNR keywords must be specified in each control stream. <_ 


Format: 


heoeiat ee tal . 


hh 
ee lor 8494 only 


, SERNR=volume-ser ial -number 
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ASGTK 
ASGPR 
ASUPD 
ASURF 


ASGTK Keyword Parameter: 
Indicates the assign alternate track routine is to be loaded and the suspected defective track/sector is 


to be checked. Note that a VOL1 card may not be present when specifying this keyword. 


ASGTK=cccchh 
Six hexadecimal numbers representing the suspected defective track. Must be specified for 


assigning an alternate track. 


i aaa 


M 
For 8494 disks only, eight hexadecimal numbers representing the suspected defective record 


(sector) or M (multiple) to interactively enter addresses of defective records. M cannot be 
specified if ASUPD=Y. 
ASGPR Keyword Parameter: 
Indicates whether all the records being read or just those records detected in error are to be listed on 


the printer. 


ASGPR=A 
All records read are listed. ASGPR=A is the default for 8494 disks. 


ASGPR=€ 
Only records detected in error are listed. 


ASUPD Keyword Parameter: 


Indicates whether update records are present in the control stream. 


ASUPD=% 
No update records are present in the control stream. 


ASUPD=Y 
Update records are present in the control stream. ASUPD=Y cannot be specified if ASGTK=M. 


ASURF Keyword Parameter: 


Indicates whether a surface analysis is to be performed on the track identified by ASGTK keyword. 


ASURF=N 
No surface analysis is performed. Alternate track is assigned automatically. ASURF=N is always 


assumed for 8494 disks. 





ASURF=8: 
Surface analysis is performed. Alternate track is assigned only if track identified by ASGTK 


keyword is found to be defective. ASURF=S is not supported for 8494 disks. 
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@ SERNR 


SERNR Keyword Parameter: 


SERNR=volume-ser ial -number 
Six alphanumeric characters representing the disk pack volume serial number. 
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UPDATE RECORDS 
Function: 


Indicates the record on the alternate track to be patched that was detected in error by a previous 
assign alternate track run. The keyword parameter ASUPD=Y must be specified. 


Format: 

rn (at l )I 
Parameters: 

rn 


Indicates the record number (2-byte hexadecimal) in error. 

DATA=([d], l) 
Indicates the displacement value (O-3 positions, relative to O) and the length value (1-4 
positions) of the data field. 


NOTES: 


1. The actual data record to be written on the track must be in hexadecimal format, containing no 
embedded blanks. 


2. The rn parameter may be the first card in the data set and the only entry on the card. 


3. The rn parameter and the DATA keyword may be coded on the same card or separate cards. 











8. Tape Prep Routine (TPREP) 
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DVC 


Function: 
Indicates the appropriate logical unit number of the tape drive being used for the tape prep. 
Format: 


// DVC nn 


Parameters: 


nn 
Logical unit number from 90-127. 
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EXEC 


Function: 
Calls the tape prep utility from $Y$LOD. 
Format: 


// EXEC TPREP 


Parameters: 


TPREP 
Program name of the tape prep utility. 


8-2 
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LBL 


Function: 
Assigns a file identifier to the tape being prepped. This statement is optional. 
Format: 


// LBL file-identifier 


Parameters: 


file-identifier 
One to 17 characters; the first character is alphabetic. 
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LFD 


Function: 


Indicates a unique file name required by TPREP. 


Format: 


// LED TAPExy 


Parameters: 


TAPExy 


where: 
Is any alphanumeric character A through Z or O through 9. 


Is either the character A, indicating ASCII mode, or blank, indicating EBCDIC mode. 
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© VOL 


Function: 
Indicates the volume serial number of the tape being prepped. 
Format: 


// VOLEIN, ]volume- serial -number (PREP) 


Parameters: 


Indicates that the tapes are to be prepped for use without block numbers. 


If omitted, the tapes will be prepped according to SYSGEN-supplied parameters; that is, if tape block 
numbers are being supported in the system, the tape prep routine will do likewise. 


volume-ser ial -number 
Six alphanumeric characters, other than SCRTCH, representing the tape serial number. 


(PREP) 
& This character string must start immediately following the last character in the 
volume-serial-number. 





9. Disk Dump/Restore Routine (HU and DMPRST) 
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& DUMP, RESTORE, and COPY — INTERACTIVE ENVIRONMENT 
Function: 


Creates backup program and data libraries stored on disk(s) to disk, tape, or diskette interactively from 
a workstation. 


NOTE: 


Tapes created from an 8430/33 disk on 8.2 and subsequent releases cannot be used to restore the 
disk on releases prior to 8.2. 


Operation: 


Enter the LOGON command. After successfully logging onto the system, enter HU in system mode. If 
your system is a model 3-6, menu screen HUOO8 appears. If your system is a model 8, 10, 15, or 
20, menu screen HUOOC appears. 


HARDWARE UTILITIES 
. DUMP FILES FROM A DISK(S) 
- RESTORE FILES TO A DISK(S) 
-« LIST FILES ON A BACKUP MEDIUM 
- COPY FILES FROM DISK TO DISK 
@ - COPY AND/OR VERIFY 8419 DISK 
- NONE OF THESE 


ENTER SELECTION __ 


HARDWARE UTILITIES 

1. DUMP FILES FROM A DISK(S) 

RESTORE FILES TO A DISKCS) 

- LIST FILES ON A BACKUP MEDIUM 

COPY FILES FROM DISK TO DISK 

COPY AND/OR VERIFY 8419 DISK 
6. COPY AND/OR VERIFY 8416/8418 DISK 
7. COPY AND/OR VERIFY 8430/8433 DISK 
8. NONE OF THESE 


ENTER SELECTION __ 
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After your selection is transmitted, a conversational message screen is displayed indicating that the job you 
selected is initiated. For example, if you entered a 1, the following conversational message screen is 
displayed. 


HUO@BIO1 


A CONVERSATIONAL JOB (HUSDMP) TO DUMP FILES FROM A DISK WILL BE 
INITIATED IN YOUR BEHALF. YOU MUST BE IN SYSTEM MODE FOR THE JOB 


TO BE SCHEDULED. IF YOU ENTERED HARDWARE UTILITIES THROUGH THE 


HU COMMAND YOU WILL BE IN SYSTEM MODE AFTER TRANSMITTING. IF YOU 
ENTERED THROUGH THE MENU COMMAND YOU ARE RESPONSIBLE FOR GOING 
INTO SYSTEM MODE. 


xkkek ~TRANSMIT TO CONTINUE ***** 





Press the XMIT key. Depending on the number entered from the menu, an appropriate set of screens is 
displayed for the operation selected. Enter the information requested on these screens, and the operation is 
performed. 
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DUMP — BATCH ENVIRONMENT 


Function: 


Writes from a disk (or disks) to a magnetic tape, diskette, or disk of a different type than the original. 
Multiple disks, tapes, and diskettes are permitted. Either data or library files are accepted. Volumes or 
files may be specified; however, file names containing embedded blanks must be delimited with 
quotation marks. File prefixes are also accepted. Dump routine checks for the correct job control 
statements and any fatal error are displayed on system console or printer (if specified). Files from 
multiple-disk volumes can be dumped to tape. The // PARAM statements indicate the operation. The 
// PARAM END statement can only be used in the volume environment, and the ccc must be specified 
in decimal. 


When dumping to disk, a MIRAM file must be allocated on the output device. The name of this file 
must appear in the job control stream on the output device’s // LBL statement. 


If a diskette is being used as the output device in a dump operation, it must first be prepped as a data ~ 


set label diskette with a record size of either 128 or 256 bytes. Since the MIRAM file DATA is 
automatically allocated during the prep operation, the diskette must use the // LBL name DATA in the 
dump operation. 


lf dumping to multivolume tapes, the output tape file names may be specified on the same // VOL 
card or they may be entered on separate // VOL cards. If the former method is chosen, only one // 
LFD card is required with the name TAPEOT specified. In this case, only one tape drive is required, 
and the output tapes are mounted as needed. If separate // VOL cards are used, a // LFD card must 
be coded for each output tape with the numbers 01 to 99 appended to the additional output tape LFD 
name (TAPEOTO1). All tapes must be mounted if this method is chosen. 


If dumping/restoring multiple-disk volumes, the volumes must all be online and of the same disk type. 
The LFD names are DISCINO1, (DISCOTO1), DISCINO2, ...DISCINnn, where nn is a value from 01 to 
16. 


Format 1. Volume Environment: 


Disk to Tape (single device assignment set) 


1 10 16 


// JOB TAPDUMP 1 

// DVC 20 // LFD PRNTR 

// DVC 50 // VOL OS3RES // LFD DISCIN 

// OVC 9@ // VOL SP0366,SP0367,SP0368 // LFD TAPEOT 
// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=TAPE 

/& 

// FIN 
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// 
// 
/& 
// 
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Disk to Tape (separate device assignment sets) 


10 16 


JOB TAPDUMP2 

DVC 20 // LFD PRNTR 

DEV 50 // VOL OS3RES // LFD DISCIN 
DVC 90 // VOL SP0366 // LFD TAPEOT 
DVC 91 // VOL SP0367 // LFD TAPEOTO1 
DVC 92 // VOL SP0368 // LFD TAPEOTO@2 
EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=TAPE 


FIN 


Disk to Diskette 


10 16 





// 
// 
// 
// 
// 
// 
// 
// 
/& 
// 


JOB DSKTDMP1 

DVC 20 // LFD PRNTR 

DVC 5@ // VOL OS3RES // LFD DISCIN 

DVC 130 // VOL DSKTO1,DSKTO2,DSKT@3,DSKTO4 
LBL DATA // LFD SEQDOT,, INIT 

EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=SEQD 


FIN 


8417 Disk to 8419 Disk 


10 16 





// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
/& 
// 


JOB. DSKDUMP 1 

DVC 2@ // LFD PRNTR 
DVC 50 // VOL DISK®1 // LFD DISCIN 
DVC 51 

VOL BKUPO1 

EXT MI,C,,CYL,800 
LBL PAYBACKUP 

LFD SEQDOT,, INIT 
EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=SEQD 
PARAM END=LAST 


FIN 
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& Format 2. File: Environment: 


// 
// 
// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 
// 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 


NOTE: 


Disk to Tape 


10 16 


JOB TFILDMP2 

DVC 20 // LFD PRNTR 

DVC 5@ // VOL MYPACK // LFD DISCIN 

DVC 99 // VOL BACKO1,BACK@2,BACK®3,BACKO4 
LFD TAPEOT 

EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=TAPE 

PARAM TYPE=FILE 


FILE RPGII 

FILE MYCOBOLMASTER 
FILE PROCFILE 

FILE ''PAY BACKUP'' 


FIN 
Multiple Disks to Tape 


10 16 


JOB MULTIDUMP 

DVC 20 // LFD PRNTR 

DVC 5@ // VOL DISCAA // LFD DISCIN@1 
DVC 51 // VOL DISCBB // LFD DISCIN@2 
DVC 52 // VOL DISCCC // LFD DISCIN®3 
DVC 96 // VOL TAPE®@O // LFD TAPEOT 
EXEC DMPRST 

PARAM IN=DISC(D01,D02,003) 

PARAM OUT=TAPE 

PARAM TYPE=FILE 


DISC Do1 
FILE PAYROLL 
DISC DO3 
FILE PAYROLL 
DISC D@2 
FILE TAXES 
DISC D3 
FILE PENSION 


9-5 
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The file “payroll” is a multiple—volume file, and two DISC and FILE statements are required to 
dump it in its entirety. Consequently, the file requires two DISC and FILE statements to restore it 


in its entirety to two separate disk volumes. 
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Disk to Diskette 





1 10 16 
a 


// JOB DSKTFIL1 

// DVC 20 // LFD PRNTR 

// DVC 5@ // VOL MYPACK // LFD DISCIN 

// DVC 130 // VOL SAVE@1,SAVE@2,SAVEO3, SAVEO4 
// LBL DATA // LFD SEQDOT,, INIT 

// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=SEQD 

// PARAM TYPE=FILE,NOWAIT 


/$ 
FILE INVENTORY 
FILE PARTS 
FILE INVOICES 
FILE.P BANK 
/* 
/& 
// FIN 
8417 Disk to 8419 Disk 
1 10-16 


// JOB DFILDMP1 


// DVC 20 // LFD PRNTR 

// DVC 5® // VOL DOO309 // LFD DISCIN 
// DVC 51 // VOL BACKUP 

// EXT MI,C,,CYL, 100 

// LBL FILESAVE 

// LFD SEQDOT,, INIT 

// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=SEQD 

// PARAM TYPE=FILE 





/$ 
FILE INTERSTPRG 
FILE MORTGAGEPRG 
FILE BALANCE 

/* 

/& 


// FIN 
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@ 8417 Fixed-Head Disk to 8419 Disk 


1 10 16 


A 


// JOB FIXDUMP3 

// DVC 20 // LFD PRNTR 

// DVC 5@ // VOL FIXVOL // LFD DISCIN 
// DVC 51 // VOL FIX001,F1X002 

// LBL DISKBACKUP // LFD SEQDOT,, INIT 
// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=SEQD 

// PARAM TYPE=FILE,ALL 

/& 

// FIN 
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RESTORE — BATCH ENVIRONMENT 


Function: 


Writes from a magnetic tape, diskette, or disk to the original disk (or disks) or a disk (or disks) of the 
same type as the original. Multiple tapes, diskettes, and disks are permitted. Either data or library files 
are accepted. Volumes or files may be specified; however, the file names containing embedded blanks 
must be delimited with quotation marks. Files must be stored in the order they appear on the tape, 
diskette, or disk. Restore routine checks for correct job control, statement and any fatal error is 
displayed on the system console or printer (if specified). The // PARAM statements indicate the 
operation. 


Several options are available for file placement if performing a disk copy or restore operation in a file 
environment. These options are implemented through the specification of parameters on the FILE 
statement. 


NOTES: 


1. Tapes created from an 8430/33 disk on 8.2 and subsequent releases cannot be used to restore 
the disk on releases prior to 8.2. 


2. Tapes created from multiple-disk volumes cannot be used to restore those volumes on releases 
prior to 12.0. 


The format of the FILE statement is: 


Format 1: 


FILE old-nameys; /ABS\) ][,new-name] 
REL 
LOG 
PRE 
SKP 


Format 2: 


FILE.P prefix-namef,; /ABS 
REL 
LOG 
PRE 
SKP 


The old-name parameter names the file being processed. The prefix-name specifies the name of all 
files with the prefix to be restored. The new-name parameter changes the name of the file being 
restored to disk. The second parameter is the allocation parameter. This parameter controls the 
processing of restored files. 


The ABS parameter indicates that the file is to be allocated on the output disk in the same absolute 
extents as it occupied on the input disk. The REL parameter specifies that the file is to be relocated. If 
enough space to hold the file is not available, the unused space is deleted and the file is relocated. 
Unused space is space allocated for a file, but not yet assigned to a partition of the file. The LOG 
parameter indicates that a file is to be allocated with all unused space deleted. The PRE parameter 
indicates that the file space for the file has been previously allocated. The SKP parameter suppresses 
the restoration of a file and is used only in diskette and tape restore operations. 
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If restoring from multivolume tapes, the input tape names may be specified on separate // VOL cards 
or on the same // VOL card. However, whatever method was used to dump the files must be used 
when restoring them. If entered on separate // VOL cards, a separate // LFD must be entered for 
each tape volume with the first volume named TAPEIN and the numbers 01 through 99 appended to 


each additional volume (TAPEINO1). 


If restoring from multivolume diskettes or tapes, the ANY parameter on the // PARAM TYPE=FILE 


statement supports restoring from a volume other than the first volume. 


Format 1. Volume Environment: 


Tape to Disk (multivolume restore using single device assignment set) 


1 10 16 


A 


//JOB TAPERSTR1 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL SP0366,SP0367,SP0368 // LFD TAPEIN 
// DVC 50 // VOL OS3RES // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC 


/& 
// FIN 

Tape to Disk (multivolume restore using separate device assignment sets) 
1 10 16 


ED 


// JOB TAPERSTR2 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL SPO366 // LFD TAPEIN 
// DVC 91 // VOL SPO367 // LFD TAPEIN®1 
// DVC 92 // VOL SP0368 // LFD TAPEIN@2 
// OVC 5@ // VOL OS3RES // LFD DISCOT 
// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC 

/& 

// FIN 


Diskette to Disk 


1 10 16 


// JOB DSKTRST 

// DVC 20 // LFD PRNTR 

// DVC 130 // VOL DSKTO1,DSKT@2,DSKTO3,DSKTO4 
// LBL DATA // LFD SEQDIN 

// OVC 5@ // VOL OS3RES // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=SEQD 

// PARAM OUT=DISC 

/& 

// FIN 
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8419 Disk to 8417 Disk 


10 16 


i 


// 
// 
// 
// 
/f 
// 
// 
// 
/& 
// 


JOB DISKRST1 

DVC 20 // LFD PRNTR 

DVC 5@ // VOL BKUPO1 

LBL PAYBACKUP // LFD SEQDIN 

DVC 51 // VOL DISK#1 // LFD DISCOT 
EXEC DMPRST 

PARAM IN=SEQD 

PARAM OUT=DISC 


FIN 


Format 2. File Environment: 





Tape to Disk 
1 19 16 
// JOB RENAME 
// DVC 20 // LFD PRNTR 


// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 
// 


DVC 90 // VOL BACKO1,BACK02,BACKO3,BACKO4 
LFD TAPEIN 

DVC 50 // VOL MYPACK // LFD DISCOT 

EXEC DMPRST 

PARAM IN=TAPE 

PARAM OUT=DISC 

PARAM TYPE=FILE 


FILE RPGII,REL,RPGII@2 
FILE MYCOBOLMASTER,ABS 
FILE PROCFILE,,PROCFILE@2 
FILE ''PAY BACKUP’! 


FIN 
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Tape to Multiple Disks 





1 10 16 


// JOB RESTORE 

// DVC 20 // LFD PRNTR 

// DVC 96 // VOL TAPE@O // LFD TAPEIN 
// DVC 5@ // VOL DISCAA // LFD DISCOTO1 
// DVC 51 // VOL DISCCC // LFD DISCOT®3 
// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC(D01,D03) 

// PARAM TYPE=FILE 


/$ 
DISC D1 
FILE PAYROLL 
DISC DO3 
FILE PAYROLL 

/* 

/& 

// FIN 
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// 
// 
// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 
// 


// 
// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 
// 


SYSTEM SERVICE PROGRAMS Update C 


Diskette to Disk 


10 16 


JOB STDRSTO1 

DVC 20 // LFD PRNTR 

DVC 130 // VOL SAVE@1,SAVE@2,SAVEO3, SAVEO4 
LBL DATA // LFD SEQDIN 

DVC 5@ // VOL MYPACK // LFD DISCOT 

EXEC DMPRST 

PARAM IN=SEQD 

PARAM OUT=DISC 

PARAM TYPE=FILE 


FILE INVENTORY 
FILE PARTS,SKP 
FILE INVOICES 


FIN 


8419 Disk to 8417 Disk 


16 16 


JOB STDRST@2 

DVC 26 // LFD PRNTR 

DVC 50 // VOL BACKUP // IBL FILESAVE // LFD SEQDIN 
DVC 51 // VOL D88688 // LFD DISCOT 

EXEC DMPRST 

PARAM IN=SEQD 

PARAM OUT=DISC 

PARAM TYPE=FILE 


FILE INTERESTPRG 


FILE MORTGAGEPRG 
FILE BALANCE 


FIN 
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DISK COPY — BATCH ENVIRONMENT 


Function: 


9-11 


Copies a disk to another disk of the same device type. Either data or library files are accepted. 
Volumes or files may be specified; file names containing embedded blanks must be delimited with 
quotation marks. Copy routine checks for the current job control statements and any fatal errors are 
displayed on the system console or printer (if specified). The // PARAM statements indicate the 


operation. The // PARAM END statement can only be used in the volume environment, and the ccc 


must be specified in decimal. 
Format 1. Volume Environment: 


4 10 16 


// JOB DSKCOPY2 

// OVC 20 // LFD PRNTR 

// DVC 5@ // VOL OS3RES // LFD DISCIN 
// DVC 51 // VOL RESBAK // LFD DISCOT 
// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=DISC 

// PARAM END=LAST 

/& 

// FIN 


Format 2. File Environment: 


1 10 16 


cr a 


// JOB DFILCPY 

// DVC 2@ // LFD PRNTR 

// DVC 5@ // VOL DISKO1 // LFD DISCIN 
// DVC 51 // VOL DISK@2 // LFD DISCOT 
// EXEC DMPRST 

// PARAM IN=DISC 

// PARAM OUT=DISC 

// PARAM TYPE=FILE 

// PARAM NOEXPCT 


/$ 
FILE MONEY 
FILE INTEREST 
FILE BILLS 
FILE.P BANK 

/* 

/8 

// FIN 
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// 
// 
// 
// 
// 
// 
// 
// 
/$ 


/* 
/& 
// 
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File Copy to Same Disk 


10 16 


JOB FILCOPY 

DVC 20 // LFD PRNTR 

DVC 50 // VOL DISK®1 // LFD DISCIN 
DVC 50 // VOL DISK@1 // LFD DISCOT 
EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=DISC 

PARAM TYPE=FILE 


FILE MYFILE, ,MYFILE@2 


FIN 


Disk to Disk Copying Entire Volume of Active Files 


10 16 





// 
// 
// 
// 
// 
// 
// 
// 
/8& 
// 


JOB COPYALL 

DVC 20 // LFD PRNTR 

DVC 50 // VOL DISK®1 // LFD DISCIN 
DVC 51 // VOL DISK@2 // LFD DISCOT 
EXEC DMPRST 

PARAM IN=DISC 

PARAM OUT=DISC 

PARAM TYPE=FILE,ALL 


FIN 
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TAPE COPY — BATCH ENVIRONMENT 
Function: 


Copies a tape that was created by a previous running of DMPRST to another tape. This function is 
only applicable for tapes produced in the volume environment. DMPRST will not copy tapes produced 
in the file environment. DMPRST cannot be utilized to copy multivolume tape files to tape. 


Format: 


1 10 16 


// JOB TAPECOPY 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL PAY@@2 // LFD TAPEIN 
// OVC 91 // VOL PAY@@3 // LFD TAPEOT 
// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=TAPE 

/& 

// FIN 
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DISKETTE COPY — BATCH ENVIRONMENT 
Function: 


Copies a diskette that was created by a previous running of DMPRST to another diskette. You can 
also copy the contents of a diskette, created in the file environment, to another diskette. Unlike the 
disk copy operation, however, you cannot copy individual files. Instead, the entire contents of the 
diskettes that you specify in your control stream as your input file are copied. To perform a diskette 
copy operation in the file environment, you must include the // PARAM TYPE=FILE statement in your 
contro! stream. Any data cards defining specific files must be omitted. 


Format 1. Volume Environment: 


4 10 16 


// JOB DSKTCOPY 

// DVC 20 // LFD PRNTR 

// DVC 130 // VOL COPY@1,COPY®2,COPYO3 
// LBL DATA // LFD SEQDIN 

// DVC 131 // VOL COPYGA,COPYOB,COPYOC 
// LBL DATA // LFD SEQDOT 

// EXEC DMPRST 

// PARAM IN=SEQD 

// PARAM OUT=SEQD 

/8 

// FIN 


Format 2. File Environment: 


1 10 16 


// JOB COPYDSKT 

// DVC 20 // LFD PRNTR 

// DVC 130 // VOL COPY@1,COPY@2,COPYO3 
// LBL DATA // LFD SEQDIN 

// DVC 131 // VOL COPYOA, COPY@B, COPYOC 
// LBL DATA // LFD SEQDOT 

// EXEC DMPRST 

// PARAM IN=SEQD 

// PARAM OUT=SEQD 

// PARAM TYPE=FILE 

/& 

// FIN 
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RESTARTING DISKETTE DMPRST — BATCH ENVIRONMENT 


The DMPRST routine allows you to restart a diskette dump or restore operation that was prematurely 
terminated; saving you from re-running the entire job. 


You can restart a diskette DMPRST operation in either the volume or file mode. The statement that is 
added to the original control stream to activate the restart function is: 


// PARAM RESTART 


Before the restart is attempted, a diskette that was completely processed by the original job must be 
‘mounted. The volume serial numbers of the diskettes not being used must be replaced by commas. So, if 
you originally specified 


// VOL A,B,C,D,E,F 


and you're restarting the job with volume C, you would change the VOL statement to the following: 


// VOL ,,C,0,E,F 


In the file environment, the FILE statements must be listed exactly as they appeared in the original job. 


The following examples are used to show a restart procedure. The first example is the control stream for 
the original job. The second example is the control stream used to perform the actual restart. 


Example 1. Original Diskette File Restore Operation: 


// JOB DSKTRST 

// DVC 20 // LFD PRNTR 

// DVC 13@ // VOL DSKTO1,DSKTO2,DSKTO3,DSKTO4,DSKT@5 , DSKT6 
// LBL DATA // LFD SEQDIN 

// DVC 5@ // VOL MYPACK // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=SEQD 

// PARAM OUT=DISC 

// PARAM TYPE=FILE 


/$ 
FILE INVENTORY 
FILE PARTS, SKP 
FILE INVOICES 
FILE CREDITS 
FILE PAYMENTS, SKP 

/* 

/8& 


// FIN 
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Example 2. Restart Control Stream for Original Job: 





// JOB DSKTRST 

// DVC 2@ // LFD PRNTR 

// DVC 130 // VOL ,,,DSKTO4,DSKTO5 ,DSKT06 
// LBL DATA // LFD SEQDIN 

// DVC 5@ // VOL MYPACK // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=SEQD 

// PARAM OUT=DISC 

// PARAM RESTART 

// PARAM TYPE=FILE 


/$ 
FILE INVENTORY 
FILE PARTS,SKP 
FILE INVOICES 
FILE CREDITS 
FILE PAYMENTS, SKP 

/* 

/& 

// FIN 


The restart control stream in Example 2 is basically the same as the original contro! stream. In the original 
job, however, DMPRST was processing DSKTOS when the termination occurred. Therefore, the last volume 
completely processed, DSKT04, is mounted first for the restart job. Notice that the volume serial numbers 
of the diskettes not being used in the restart job are replaced with commas. The remainder of the control 
stream in Example 2 is identical to the original except for the // PARAM RESTART statement that is added 
to activate the restart function. 
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RESTARTING TAPE DMPRST — BATCH ENVIRONMENT 


You can restart a tape dump or restore operation that terminated permaturely, unless the tape was created 
with a release prior to 12.0. The operation can be in either volume or file mode. 


When restarting a tape operation, refer to the output of the original job. Messages are put out by DMPRST 
when reading and writing tapes to indicate when a tape is first being read or written. DMPRST also puts 
out a message when it is finished reading (closing) a tape. Mount a tape that DMPRST has already written 
to or read from; or, if restoring, mount the next volume after one that was closed. The first volume of the 
operation can never be mounted for a restart; the original job must be rerun. 


The original job control stream must be altered for the restart. If the original // VOL statement for the tapes 
appears as: 


// NOL tapeO1,tape@2,taped3 


and DMPRST started to read(write) tapeO2, the statement must be changed as follows: 


// VOL ,,tape@2,tapee3 


Note that an extra comma must be entered. 
A // PARAM RESTART statement must also be added to the job stream. 


At this point, if you are running DMPRST in volume mode, you are ready to restart by running your revised 
job stream. However, if you are running in file mode and you are restarting a restore operation, some 
changes may be required for the FILE statements if you are not restoring all files. A FILE statement with a 
SKP parameter must be added for any file that is not being restored and which precedes one on the tape 
that is being restored. 


The following example shows a restart for a restore. The first control stream is for the dump that created 
the tape input for the restore. The second is the control stream for the restore. The third is for the restart. 


1. The control stream to dump the files: 


// JOB TAPEDUMP 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL TAPE@1,TAPE@2,TAPE®@3S // LFD TAPEOT 
// DVC 50 // VOL MYPACK // LFD DISCIN 

// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC 

// PARAM TYPE=FILE 


/$ 
FILE INVENTORY 
FILE PARTS 
FILE INVOICES 
FILE CREDITS 
FILE PAYMENTS 

/* 

/& 


// FIN 
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2. Control stream for the original restore job (note that inventory and parts are not being restored): & 





// JOB TAPERSTR 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL TAPE@1,TAPE@2,TAPE®@3 // LFD TAPEIN 
// DVC 5@ // VOL MYPACK // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC 

// PARAM TYPE=FILE 


/$ 
FILE INVOICES 
FILE CREDITS 
FILE PAYMENTS 

/* 

/& 

// FIN 


3. Restart control stream: 


// JOB TAPERSTR 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL ,,TAPE@2,TAPE@3 // LFD TAPEIN 
// DVC 5@ // VOL MYPACK // LFD DISCOT 

// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM OUT=DISC 

// PARAM TYPE=FILE 

// PARAM RESTART 





/$ 
FILE INVENTORY, SKP 
FILE PARTS, SKP 
FILE INVOICES 
FILE CREDITS 
FILE PAYMENTS 

/* 

/& 


// FIN 
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LIST — BATCH ENVIRONMENT 
Function: 

Prints the names of all files backed up on a tape, on diskette or on a sequential file on disk. 
Format: 


// JOB LIST 

// DVC 20 // LFD PRNTR 

// DVC 9@ // VOL TAPEO1 // LFD TAPEIN 
// EXEC DMPRST 

// PARAM IN=TAPE 

// PARAM TYPE=FILE,LIST 

/& 

// FIN 











10. List Software Maintenance Correction Routine 
(SMCLIST) 
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SCOPE 

You can use the SMCLIST canned job control stream to print a listing of the software maintenance 
corrections contained in the SMCLOG file. This listing is printed in either a full or condensed format, 
depending on which option you choose. Also, by specifying certain parameters, you can produce listings 
sorted by SMC number, component number, program-product-type number, date, and time. 


OPERATING INSTRUCTIONS FOR EXECUTING SMCLIST 


The format of the SMCLIST canned job control stream is: 








RV SMCLISTJ, {, FMT={F 7 SEQ1= 7 S9EQ2=/ COMP [,V=vsn] 
£ DATE DATE 
TIME TIME 
PP-TYPE PP-TYPE 
SMCH 
nnnn-nn nnnn-nn 
where: 
seals 
¢ 


Specifies the format of the listing being produced. 


FMT=F 
Specifies that a full listing is printed. 


FMT=@ 


Specifies that a condensed listing is printed. 


A full listing is a listing sorted primarily by component number and then by SMC number. It gives 
more information about each SMC than a condensed listing, such as the regenerations an SMC 
requires or the method used to install it. 


Since you don't always need as much information as the full listing shows, we also provide a 
condensed listing. A condensed listing contains only SMC numbers in ascending order and an 
indication of whether any SMCs were backed out, replaced, or were not installed because of an error 
during installation. 


The default for the FMT parameter is C for condensed. Unless you specify FMT=F on your SMCLIST 
run command, you will always receive a condensed listing of the SMCs in the SMCLOG file. 


SEQ1= 
Is the primary sorting key to be used. 





Specifies by component number. 
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SEQ1=DATE 
Specifies the date the SMCs were applied. 


SEQ1=TIME 
Specifies the time the SMCs were applied. 


SEQ1=PP-TYPE 
Specifies program-product-type number. 


SEQ1=SMC# 
Specifies by SMC number. 


SEQ1=nnnn-nn 
Specifies that only those SMCs with a program-product-type number of nnnn-nn will be 
printed. 


If you omit this keyword, the full listing is sorted primarily by component number. 


SEQ2= 
Is the secondary sorting key to be used. 


SEQ2=COMP 
Specifies component number. 


SEQ2=DATE 
Specifies the date the SMCs were applied. 


SEQ2=TIME 
Specifies the time the SMCs were applied. 


SEQ2=PP-TYPE 
Specifies program-product-type number. 





Specifies SMC number. 


SEQ2=nnnn-nn 
Specifies that only those SMCs with a program-product-type number of nnnn-nn will be 
printed. 


If you omit the SEQ2 keyword, the secondary sorting key is the SMC number. 


NOTES: 


The SEQ1 specification may not be the same as the SEQ2 specification. 


If nnnn-nn is specified for SEQ1 or SEQ2, any SMCs that were replaced do not appear in the 
listing. 


V=vsn 


Specifies the volume serial number for a system release pack other than RES. 











11. Diskette Copy Routine (SU$CPY) 
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SCOPE 


This routine enables the programmer to generate up to three copies of an 8420/8422 diskette. SUSCPY 
also gives you the option of verifying the diskettes once you've copied them. 


OPERATING INSTRUCTIONS FOR EXECUTING SUSCPY 


The SUSCPY routine can be initialized by keying in the following: 


RV SUSCPY, ,N={ 1 
2 
3 


where: 
N=(1 
2 
3 
Specifies the number of copies you're making. 
During the execution of the SUSCPY routine, you are asked to reply to the following messages: 


MESSAGE 1: ji NUMBER OF COPIES REQUIRED OF OUTPUT 2,3 DEFAULT=1 


REPLY: Press the transmit key to default to the number of copies you originally requested in 
the RV SUSCPY command. If you want to change the number of copies you originally 
requested, enter the job number and message-id (jji) and then the number of the 
copies wanted (1,2, or 3). Press the transmit key. The number specified overrides that 
originally specified in the RV SUSCPY command. Message 2 appears on the screen 
after you transmit your reply. 


MESSAGE 2: ji TYPE OF OPERATION: COPY, VERIFY 
REPLY: You should reply by keying in one of the following specifications: 
C 
Indicates that you are making copies. 
Indicates that you are verifying a diskette. 


If no reply is given to this message and you press the XMIT key, the C option is assumed 
and message 3 appears on the screen. 
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MESSAGE 3: ji 2N=NEXT DISKETTE MOUNTED OR DEFAULT=FINAL DISKETTE 


REPLY: lf more diskettes are to be copied, remove the current diskette, mount the next 
diskette to be copied, and reply by keying in N. This resumes the message sequence 
starting at message 2. To terminate the job, press the XMIT key instead of replying to 
the message. If you want to verify a copy, key in the N parameter and press the XMIT 
key. This resumes the message sequence starting at message 2. To verify the copy, 
simply key in V and press the XMIT key. 


NOTE: 
Only one diskette can be verified each time you execute SU$CPY. So, if you are making more than one 


copy in a single execution of SU$CPY, only the first copy can be verified. To verify the remaining copies, 
you must run separate SU$CPY operations using the V (verify) option for each individual copy. 








12. 8419 Disk Copy Routine (HU and SU$C19) 
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SU$C19 — INTERACTIVE ENVIRONMENT 


Function: 


Create and verify up to six copies of a single 8419 disk, regardless of the disk contents. 


Operation: 


12-1 
Update C 


Enter the LOGON command. After successfully logging onto the system, enter HU in system mode. If Y 
your System 80 is a model 3-6, MENU screen HUOOB appears. If your system 80 is a model 8, 10, 
15, or 20, MENU screen HUOOC appears. 


HARDWARE UTILITIES 
DUMP FILES FROM A DISK(S) 
RESTORE FILES TO A DISK(S) 
LIST FILES ON A BACKUP MEDIUM 
COPY FILES FROM DISK TO DISK 


NONE OF THESE 
ENTER SELECTION 


HARDWARE UTILITIES 
DUMP FILES FROM A DISK(S) 


RESTORE FILES TO A DISK(S) 


» LIST FILES ON A BACKUP MEDIUM 
- COPY FILES FROM DISK TO DISK 


& 


. COPY AND/OR VERIFY 8416/8418 DISK 


COPY AND/OR VERIFY 8430/8433 DISK 


. NONE OF THESE 


A CONVERSATIONAL JOB (HUSCPY) TO COPY FILES FROM ONE DISK TO 
ANOTHER WILL BE INITIATED IN YOUR BEHALF. 
MODE FOR THE JOB TO BE SCHEDULED. 


UTILITIES THROUGH THE HU COMMAND YOU WILL BE IN SYSTEM MODE 


AFTER TRANSMITTING. 


ENTER SELECTION 





ARE RESPONSIBLE FOR GOING INTO SYSTEM MODE. 





*xkxkkk =~TRANSMIT TO CONTINUE 


YOU MUST BE IN SYSTEM 
IF YOU ENTERED HARDWARE 


IF YOU ENTERED THROUGH THE MENU COMMAND YOU 


Select 5 from the MENU screen. Press the XMIT key. Following the MENU screen, a conversational 
message screen is displayed, indicating that the job is initiated. 


Press the XMIT key. An appropriate set of screens is displayed asking for the required device and file 
information. After the information is given, the copy operation is performed. 
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SU$C19 — BATCH ENVIRONMENT (PARAM Statement) 


Function: 
There are seven keyword parameters associated with copying an 8419 disk. All of the keyword 
parameters have default values. If all of the defaults are assumed, there is no need to supply the // 


PARAM statement. 


Format: 


ieee nee ae) 
ic 
ta 











COPY Keyword Parameter: 


Indicates the number of copies to be made or the number of copies to verify when using the OVEF 
parameter. If omitted, one copy is assumed. 


BGAD Keyword Parameter: 


Indicates the beginning cylinder address, in decimal, for duplication or verification. The address must 
be the cylinder address (ccc). If omitted, the beginning address is 000. 


EDAD Keyword Parameter: 


Indicates the ending cylinder address, in decimal, for duplication or verification. The address must be 
the cylinder number (ccc). If omitted, the ending address is 808. 


OVEF Keyword Parameter: 





No verify-only operation is performed. 


OVEF=YES 
A verify-only operation is performed. 


PRNT Keyword Parameter: 





Only fatal errors are displayed on the system console. 


PRNT=YES 
All errors detected are printed, listing both the input and output records. Normally used in 
conjunction with VEFY=YES. 
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UNXF Keyword Parameter: 


UNXF 





No file expiration date checking is performed. 


UNXF=YES 
File expiration date checking is performed. 


VEFY Keyword Parameter: 





No verification is performed on the output disk pack. 


VEFY=YES 
Verification is performed on all disks being copied. 





13. 8416/8418 Disk Copy Routine 
(HU and SU$C16) 
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@ SU$C16 — INTERACTIVE ENVIRONMENT 
Function: 
Create and verify up to seven copies of a single 8416 or 8418 disk (regardless of the disk contents). 
Operation: 
Enter the LOGON command. After successfully logging onto the system, enter HU in system mode to 


initiate the hardware utility. The following MENU screen appears: 


HARDWARE UTILITIES 


- DUMP FILES FROM A DISK(S) 
RESTORE FILES TO A DISK(S) 
LIST FILES ON A BACKUP MEDIUM 
COPY FILES FROM DISK TO DISK 
COPY AND/OR VERIFY 8419 DISK 


. COPY AND/OR VERIFY 8430/8433 DISK 
. NONE OF THESE 


ENTER SELECTION [EQ 





@ Select 6 from the MENU screen. Press the XMIT key. Following the MENU screen, a conversational 
message screen is displayed, indicating that the job is initiated. 


HU@OCIO5 
A CONVERSATIONAL JOB (HUSC16) TO COPY THE CONTENTS OF ONE 8416/ 
8418 DISK TO ONE OR MORE DISKS OR TO VERIFY THE CONTENTS OF ONE 
OR MORE DISKS HAS BEEN INITIATED IN YOUR BEHALF. YOU MUST BE 


IN SYSTEM MODE FOR THE JOB TO BE SCHEDULED. IF YOU ENTERED 
HARDWARE UTILITIES THROUGH THE HU COMMAND YOU WILL BE IN SYSTEM 
MODE AFTER TRANSMITTING. IF YOU ENTERED THROUGH THE MENU 
COMMAND YOU ARE RESPONSIBLE FOR GOING INTO SYSTEM MODE. 

*xeee TRANSMIT TO CONTINUE ***** 





Press the XMIT key. An appropriate set of screens is displayed, asking for the required device and file 
information. After the information is given, the COPY operation is performed. 
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SU$C16 — BATCH ENVIRONMENT (PARAM Statement) 


Function: 


There are seven keyword parameters associated with copying a sectored disk pack. All the keyword 
parameters have default values; however, the // PARAM statement must be specified even if all the 


defaults are assumed. 
Format: 


// PARAM COPY=(n) [,BGAD=(ccc,, 
(a ‘ccch,, 






ccchrr,, 
7 EDAD=/ccc,, , OVEF={N@ | 
ccch,, YES 


ccchrr,, 


for 8416 and 8418 low 
r for 8418 high 


remem ey (eee 


COPY Keyword Parameter: 











' Indicates the number of copies of the input disk pack to be made, where n may be from 1 to 7. 
If omitted, one copy is made. 


BGAD Keyword Parameter: 


Indicates the starting address, in hexadecimal, of the disk copy. The starting address can be specified 
in cylinder (ccc), cylinder and head (ccch), or cylinder, head, and record (ccchrr) formats. 


If omitted, cylinder 000, head O, and record 01 is assumed. 


EDAD Keyword Parameter: 


Indicates the ending address, in hexadecimal, of the disk copy. The ending address can be specified in 
cylinder (ccc), cylinder and head (ccch), or cylinder, head, and record (ccchrr) formats. 


If omitted, the following addresses are assumed: 
a Cylinder 193, head 6, record 28 for 8416 and 8418 low 


a Cylinder 327, head 6, record 28 for 8418 high 
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€ OVEF Keyword Parameter: 





One or more copies are made, with or without verification. 


OVEF=YES 
A verify-only operation is performed. 


PRNT Keyword Parameter: 





Only fatal errors are displayed on the system console. 
PRNT=YES 
All errors detected are printed, listing both the input and output records. Normally used in 
conjunction with VEFY=YES. 
UNXF Keyword Parameter: 


UNXF=NO 
No file expiration date checking is performed. 





UNXF=¥ES. 
File expiration date checking is performed. 


@ VEFY Keyword Parameter: 





No verification is performed on the output disk pack. 


VEFY=YES 
Verification is performed on all disk packs being copied. 





14. 8430/8433 Disk Copy Routine 
(HU and SU$CSL) 
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SU$CSL — INTERACTIVE ENVIRONMENT (PARAM) 


Function: 
Create and verify up to seven copies of a single 8430 or 8433 disk (regardless of the disk contents). 
Operation: 


Enter the LOGON command. ‘After successfully logging onto the system, enter HU in system mode to 
initiate the hardware utility. The following MENU screen appears: 


HARDWARE UTILITIES 
DUMP FILES FROM A DISK(S) 
RESTORE FILES TO A DISK(S) 
LIST FILES ON A BACKUP MEDIUM 
COPY FILES FROM DISK TO DISK 
COPY AND/OR VERIFY 8419 DISK 
COPY AND/OR VERIFY 8416/8419 DISK 


NONE OF THESE 
ENTER SELECTION 





Select 7 from the MENU screen. Press the XMIT key. Following the MENU screen, a conversational 
message screen is displayed, indicating that the job is initiated. 


HU®OC 106 


A CONVERSATIONAL JOB (HUSCSL) TO COPY THE CONTENTS OF ONE 
8430/8433 DISK TO ONE OR MORE DISKS OR TO VERFIY THE CONTENTS OF 
ONE OR MORE DISKS HAS BEEN INITIATED IN YOUR BEHALF. 


YOU MUST BE IN SYSTEM MODE FOR THE JOB TO BE SCHEDULED. IF YOU 
ENTERED HARDWARE UTILITIES THROUGH THE HU COMMANDS YOU WILL BE IN 
SYSTEM MODE AFTER TRANSMITTING. IF YOU ENTERED THROUGH THE MENU 
COMMAND YOU ARE RESPONSIBLE FOR GOING INTO SYSTEM MODE. 

eeeKR TRANSMIT TO CONTINUE ***** X 





Press the XMIT key. An appropriate set of screens is displayed, asking for the required device and file 
information. After the information is given, the copy operation is performed. 
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SUSCSL — BATCH ENVIRONMENT (PARAM Statement) © 


Function: 


There are seven keyword parameters associated with copying a nonsectored disk pack. All the 
keyword parameters have default values; however, the // PARAM statement must be specified even if 
all the defaults are assumed. 


Format: 


cchh, 


/] PARAM Aaa ae ] 


, EDAD=/ccchh,, bs bre das ) 
: for 8430 YES 










ws 





COPY Keyword Parameter: 
Indicates the number of copies of the input disk pack to be made, where n may be from 1.to 7. 
If omitted, one copy is made. 

BGAD Keyword Parameter: 


Indicates the starting address, in hexadecimal, at which the copy operation is to end. The starting 
address must be specified in cylinder and head (ccchh) format. 


If omitted, cylinder O00, head OO is assumed. 


EDAD Keyword Parameter: 


Indicates the ending address, in hexadecimal, in which the copy operation is to end. The ending 
address must be specified in cylinder and head (ccchh) format. 


If omitted, the following addresses are assumed: 
r Cylinder 193, head 12 for 8430 


rT] Cylinder 327, head 12 for 8433 


OVEF Keyword Parameter: 





One or more copies are made, with or without verification. 


OVEF=YES 
A verify-only operation is performed. 
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@ PRNT Keyword Parameter: 





Only fatal errors are displayed on the system console. 


PRNT=YES 
All errors detected are printed, listing both the input and output records. Normally used in 


conjunction with VEFY = YES. 
UNXF Keyword Parameter: 


UNXF=NO 
No file expiration date checking is performed. 





File expiration date checking is performed. 


VEFY Keyword Parameter: 






No verification is performed on the output disk pack. 


VEFY=YES 
Verification is performed on all disk packs being copied. 





15. SYSTEM UTILITY SYMBIONT (SL$$SU) 
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SL$$SU CAPABILITIES 


There are two versions of the system utility symbiont: SU and TU. TU should be used for tape, while SU 
should be used for ail other functions. 


Table 15-1 lists the SL$$SU functions available. 


Table 15-1. SLE$SU Functions 


Function Performed 


Reproducing cards punched in Hollerith code 
Reproducing cards punched in binary and Hollerith code 
Reproducing and resequencing source programs 
Writing card to tape in unblocked format 

Writing card to tape in blocked format 

Listing cards 

Listing cards containing compressed mode 

Punching cards from the system console 

Copying a tape to another tape 

Printing a tape in character and hexadecimal format 
Printing a tape in character, hexadecimal deblocked format 
Printing a tape containing only standard characters 
Printing a tape in character and deblocked format 


Locating a specific record on tape 


Punching cards from tape 


Prepping a tape 

Forward space to a specific file 

Backward space to a specific file 

Forward space to a specific record 

Backward space to a specific record 

Writing tape marks 

Rewind a tape 

Rewind a tape with interlock 

Erasing a portion of a tape 

Displaying available disk extents on the console screen 
Printing a disk or diskette in unblocked format 
Printing a short format VTOC file 


Printing the volume table of contents of a disk or the data set labels on a 
diskette 
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CO oo eee 


DELETION 


Section 16 has been deleted. 





Appendix A. SAT Librarian Functions 
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The functions performed by the SAT librarian are supplied by means of a set of integrated subroutines, file 
tables, and overlay segments associated with the support of individual functions. 


The following outlines the tasks performed by the SAT librarian: 


Maintains all program elements within the system complex: 


User programs 


System programs 


Manages all program elements comprising the system complex: source code, proc code, object code, 
and load code. 


Performs these tasks on all or specific portions of SAT library files: 


Copying one library file to another library file by duplication or selectively as to module or module 
group 


Building a new library file composed of merged modules or groups from other libraries and media 
Adding to an existing library file 

Deleting from an existing library file 

Compressing an existing library file 

Punching modules or groups of modules onto cards 

Creating the elements from card modules or groups of card modules 

Converting standard load modules to block load modules 

Correcting loadable and object code elements based on phase/section definitions 

Renaming a specific group, module, phase, control section, or entry name 

Identifying object and load modules as reentrant or nonreentrant 

Listing a specific module or module group in the appropriate format, depending on code type 


Providing a library map of supplied control directives and status information concerning the 
content of the files being handled 


Validating library file and program structure 


Supplying meaningful, noncryptic diagnostics on a library map 
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- Providing gang operations involving certain specific file maintenance options 
- Aiding in the system generation process 
- Listing the contents of a library file in alphabetical order 


Accomplishes specific tasks in accordance with control statements directed to the SAT librarian 
through the control stream. 

















Appendix B. MIRAM Librarian Functions 
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The functions performed by the MIRAM librarian are supplied by means of a set of integrated subroutines, 
file tables, and overlay segments associated with the support of individual functions. 


The following outlines the tasks performed by the MIRAM librarian: 


a Maintains all screen format (type F and FC) modules, saved run library (J-type) modules, menu (MENU) 
modules, and help screen (HELP) modules. 


a Performs these tasks on all or specific portions of MIRAM library files: 


Copying modules from one file to another 
- Deleting modules from a file 

- Printing entire modules 

- Printing file directories 

~- Defining user files 


- Changing the name of an existing module 


Inserting comments in the header record 


a Accomplishes specific tasks in accordance with control statements directed to the MIRAM librarian 
through the control stream. 








@ Appendix C. SAT Librarian Correction Cards 
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COR CORRECTION CARDS FOR PROGRAM SOURCE AND MACRO/JPROC 
SOURCE MODULES 


The corrections made to program source or macro/jproc source modules consist of insertions and 
replacements. Deletions are accomplished as a function of insertion or replacement or as a function of three 
control statements that are used as subfunctions of the COR control statement. The three control 
statements are the recycle (REC), the sequence (SEQ), and the skip (SKI). These same subfunctions are also 
used for correcting and recording source or proc modules. 


When making source or proc module insertions or replacements, the card containing the correction is the 
actual source record. The type of correction is indicated by the sequence number specified in the sequence 
number field of the correction card. Replacements are performed on a one-to-one basis by using a 
correction card with the same sequence number as the record being replaced. Insertions are performed by 
using a correction card with a sequence number that falls between the sequence numbers of the records 
between which the correction is inserted. If an insertion consists of more than one record, only the first 
correction card must contain the sequence number. Any number of unsequenced correction cards may then 
follow. Records are inserted into the source or proc module in the same sequence in which they are 
arranged in the correction deck; cards that are out of sequence in a correction deck are inserted out of 
sequence in the source or proc module, resulting in the printing of an error message on the librarian map. 


If the corrections to a source module include the /$—/* job control statements, they must be paired and be 
without sequence numbers. 


From the preceding discussion, it can be determined that source or proc modules must contain record 
sequence identifiers in order to be corrected by the librarian. It is not a requirement, however, that source 
or proc modules carry sequence numbers to be in a given library. Sequence numbers may be added at =v 
time, during module creation from cards via the add element (ELE) control statement or thereafter via tie 
sequence (SEQ) control statement when it is used as a primary subfunction to the COR statement. 


COR CORRECTION CARDS FOR NONSOURCE MODULES 


When object or load modules are being corrected, the correction cards build a text record containing the 
data and instructions required as patch corrections necessary to the specific object or load module. Text 
records are inserted in the corrected module just ahead of the transfer record. Then, whenever the object 
or load module is loaded in main storage, its correction records are inserted in their appropriate places in 
the module, overlaying any records that may have been nullified because of their replacement. When 
patched modules are listed, patches are flagged. When changes are being made to object and load 
modules, CSECT and phase sizes may not be altered. Patches must be correctly sequenced for phased load 
modules. 


Subfunction patch corrections for object and load modules must immediately follow the COR control 
statement. 


A correction card for an object or load module must have the following format: 


Gee ,{esid-no [,text [(before-image)][,rld]] 
Pp phase-no 


ORG 


The specified address is the relative address to be assigned to the generated text record. 


A hyphen in column 1 indicates that the address is relative to the object or load module base address. A 
letter P in column 1 indicates that the address is relative to the load module phase being patched. 
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The address value must be hexadecimal and may be positive or negative. A negative address is specified 
by a hyphen in column 2, followed immediately by the address. A positive address value must begin in 
column 2. 


Any error detected in a correction card is flagged. The last correction card for the module must be followed 
by an EOD librarian control statement. 


Both text and relocation data (RLD) records may be supplied for the patch. RLD masks must be represented 
in hexadecimal 3-byte multiples. Each patch supplied causes the generation of an appropriate text record. 
Contiguous patch addresses on succeeding patches do not cause the generated text to be merged. 


Padding of a zero to the nearest half byte is automatic for the address, esid/phase-no, and text 
specifications. 


The specified hexadecimal address is relative to the base address of the object or load module if the 
hyphen (-) is used or relative to the address of the phase area if the letter P is used. This relative address is 
assigned to the generated text record. If an object module is being patched, the ESID is specified in the 


range 01-2551 if 4 load module is involved, the phase number is specified in the range 00-99. Text is 
supplied as a contiguous string of hexadecimal digits to be assigned starting at the indicated address. 
Optional RLO data (3-byte, six hexadecimal digit multiples) may be specified for the object or load text 
record being created. The minimum amount of text patchable is one byte. If no text is specified, the patch 
correction is flagged and RLD data, if present, is disallowed. As indicated, commas must separate each 
parameter. If esid/phase-no is omitted; 1 is assumed; however, the comma still must be coded. 


The use of ORG causes the location counter to be set or reset to the address specified by positional 
parameter 1. The current value of the location counter will automatically be added to all addresses specified 
in subsequent correction cards. The location counter will remain set at that value until another ORG directive 
is used or until the EOD librarian control statement is encountered. If used, the text and rid parameters must 
be omitted. 


The ‘before-image’ subparameter allows you to verify your field selection before applying the correction. 
Provide hexadecimal string of the first few bytes contained in the field to be corrected. If the comparison 
results in a match, the correction is applied. Otherwise, a diagnostic is generated and the correction is not 
made. 














Appendix D. Basic Linkage Editor Statement 
® Processing 
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The linkage editor cycles through two control modes for each load module it generates. The exact 
processing done in each mode is determined by the parameter or control statements processed in each 
mode. For this discussion, the parameter statement and control statements that affect the operation of the 
linkage editor are divided into two groups. The first group contains all the statements that direct the basic 
operation of the linkage editor and includes: 


a all job control statements directed to the linkage editor — start-of-data (/$), parameter specification (// 
PARAM), and end-of-data (/*); 


2 all LINKOP statements; and 
a the LOADM statement. 
These statements are processed in the first control mode. 


The second group of statements consists of those which basically affect the structure and content of the 
load module, rather than the operation of the linkage editor. All remaining linkage editor control statements 
make up this group and are processed in the second control mode. 


All group 1 statements input to the linkage editor for the purpose of building any given load module may 
come from the primary control stream, plus any number of user source libraries. (See // PARAM and 
LINKOP CLIB keyword description.) All group 2 statements, however, must come from a single source. The 
first group 2 statement detected starts mode 2 processing, and mode 2 processing continues until 
INCLUDE processing is ended for the load module. A given load module may thus pick up options and its 
load module name from muitiple sources, but its structure must be defined in a single input source (primary 
control stream input or user source library). 


User source libraries for linkage editor statements are specified by the CLIB keyword of the // PARAM 
statement or the LINKOP control statement. The processing performed when building a load module 
depends, in some respects, on the source that contains the CLIB specification. In most cases, the 
statement containing the CLIB specification is the last statement processed for the current load module from 
the source that contains the CLIB specification. The only exception to this is if the source specified by the 
CLIB specification contains only group 1 statements. If the linkage editor statements are being input from 
the primary control stream when the CLIB specification is processed, the current location in the control 
stream is saved and is the point of return when the statements in the specified source are exhausted. In 
contrast, if a CLIB specification is processed while in a source library, the source library is disconnected and 
can never be returned. Thus, it can be seen that multiple CLIB specifications can be meaningfully specified 
only in the primary control stream because only the first CLIB specification in a source module will ever be 
processed. 


A single link-edit job step that produces multiple load modules proceeds as follows: 

1. | Enters mode 1 and processes group 1 control statements for first load module to be produced 
2. Enters mode 2 and processes all group 2 control statements to produce first load module 

3. | Reenters mode 1 and processes group 1 control statements for second load module 

4, Reenters mode 2 and processes group 2 control statements to produce second load module 


5. Repeats steps 3 and 4 until all load modules are produced 
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The following is a list of the basic control statements used for directing the operation of the linkage editor: 


a Specify linkage editor options (LINKOP or // PARAM) 


r | Begin load module (LOADM) 


a Include object code (INCLUDE) 


r Begin overlay phase (OVERLAY) 


a Begin new region (REGION) 


rT] Define phase entry point (ENTER) 


s Define label (EQU) 


a Modify location counter (MOD) 


a Reserve storage (RES) 





Table D—1 lists the linkage editor control statements, their use, and placement in the job stream. 


INCLUDE 
LINKOP 


Table D—1. Linkage Editor Statements (Part 1 of 2) 


Specifies the start-of-execution (program entry) point for the phase currently 
being built in a load module. This is the point to which control is optionally 
transferred once the phase has been loaded in main storage. The transfer point 
is optionally assigned by the linkage editor if no such statement is supplied 
for a phase. This statement is normally the last specified for each phase 
defined in a load module. 


Equates an otherwise undefined label with a defined label in a load module. The 
normal method of defining and satisfying cross-references by the linkage editor 

is via the proper INCLUDE directives and external symbol dictionary (ESD) records 
in object code inctuded in the load module. This statement, however, allows the 
programmer to equate two symbols, a symbol and a value, or a value only that 
could not otherwise be resolved in the link-edit run. If one symbol is being 

equated to another, the equating symbol must have been previously defined. 


Tells the linkage editor to include in the load module being built a named 

object module or object module elements. Also specifies the name of the module 
and module elements, if applicable, required to be in the load modute segment 
currently under construction and may also identify the file in which the 
specified module is located 


Specifies the linkage editor processing options that are to be in effect during 
building of a load module. These options include: 


a method of determining which libraries are to be scanned by the 
INCLUDE control statement, if no filename is explicitly designated 
by the user on the tNCLUDE control statement; 


disallowing the automatic inclusion of object modules in the load module 
by the linkage editor: 


disaltowing the automatic overlay mechanism of the linkage editor from 
being included in the load module; 





Placement Guidelines 





Normally, the last statement specified for 
each phase defined in a !oad module 


May not be embedded in an automatically 
included object module 


May follow a LINKOP, LOADM, OVERLAY, or 
REGION control statement 


Must be followed by at least one object module 
header record; then may be followed by any 
number of embedded control statements, which are 
followed by a transfer record and, again, any 
number of embedded control statements 


May follow a LINKOP, LOADM, OVERLAY, or 
REGION control statement 


Must not immediately follow an ENTER control 
statement 


May precede an INCLUDE, EQU, MOD, or RES 
statement 


May not be embedded in an automatically 
included object module 


May not be specified outside of the linkage 
editor control stream proper (data set} 
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Table D—1. Linkage Editor Statements (Part 2 of 2) 


disallowing the promotion of common storage sections by the linkage editor; 


selecting the output file in which the load module created by the linkage 
editor is to be stored; 


ending a link-edit job if a processing error is detected; 
selecting the components of the link-edit map to be output for a load module; 
inserting comments in the phase header records produced by the linkage editor. 


disallowing the recognition of reentrant object modules during the include 
process; and 


initiating the building of reentrant ioad modules. 


Causes linkage editor to begin building a new load module when it follows 
an INCLUDE, EQU, MOD, or RES statement. This feature is intended for 
use only when building multiple ioad modules in a single job step. 


Requests the linkage editor to begin building an executable toad module. Also 
initiates the creation of the start of the root phase segment and specifies 
a name for the load module 


Modifies the current program counter that the linkage editor maintains when 
building a load module 


Permits the programmer to accomplish boundary adjustments at link-edit time 
outside the realm of the makeup of modules and code being included 


Directs linkage editor to begin building a new !oad module phase separate 


from the initial phase and any other previously defined phase. Identifies 
the object module elements to be included in the new load module phase 


Causes a new phase to be created in a new region of the load module. Has all 


the attributes of the OVERLAY control statement and, in addition, initiates the 
building of a new load module region 


Directs linkage editor to reserve a blank (additional) storage area at the 
end of the longest path in the load module being built. This area may be used 
by the load module program as a temporary storage or scratch area. 


HPARAM 


NOTES 


Performs the same function as the LINKOP control statement but cannot be 
specified as part of the linkage editor data set 


Placement Guidelines 


Normally the first control statement in 
each link-edit job 


May precede an INCLUDE, EQU, MOD, or 
RES control statement 


May not be embedded in an automatically 
included object module 


May follow a LINKOP, LOADM, OVERLAY, or 
REGION control statement 


May precede an INCLUDE, EQU, MOD, or 
RES control statement 


May not be embedded in an automatically 
included object module 


May precede an INCLUDE, EQU, MOD, or 
RES control statement 


May not be embedded in an automatically 
included object module 


May follow a LINKOP, LOADM, OVERLAY, or 
REGION control statement 


May be specified in the job control stream 
but not in the linkage editor control 
stream proper (data set) 





1. Embedded control statements may be placed before or after the CSECTs in an object module but may not be placed within a CSECT. They must, however, be 
inserted in the object modules prior to their being link-edited. The system librarian ts used to perform this function. 


2. Embedded statements are processed as are other contro! statements, except when a statement that affects the structure of a load module (LINKOP, LOADM, 
OVERLAY, REGION, ENTER} is detected wn an automatically included module. Because automatically included modules always are included in the root phase 
of a load module, these statements are not permitted to be embedded in automatically included modules and are flagged as errors in the link-edit map. 


3. Ail the control statements embedded in an object module are processed by the linkage editor, even if the object module is being accessed for a partial inclusion 


of its object code. 


4, None of the statements are required to appear in any linkage editor control stream. In fact, a linkage editor control stream need not exist at all for the linkage 
editor to build a load module; in this case, by default, the linkage editor, when executed, builds a single-phase load module named LNKLOD by using ali the 
object module elements currently residing in the system job run library file (SYSRUN). 








Appendix E. Program Names 
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The following defines the name of all routines that make up the system service programs. 


Routine 

SAT librarian 

MIRAM librarian 
Linkage editor 
Disk/diskette prep 
Assign alternate track 
Tape prep 
Disk/dump/restore 


Listing of software maintenance 
corrections 


Diskette copy routine 
8416/8418 disk copy routine 
8419 disk copy routine 
8430/8433 disk copy routine 
Create File Definition Program 


System Utility Symbiont 


Name 





LIBS 
MLIB 
LNKEDT 
DSKPRP 
DSKPRP 
TPREP 
DMPRST 


RV SMCLIST (operator keyin) 


RV SUSCPY (operator keyin) 
SU$C 16 

SU$C19 

SU$CSL 

CFDP 


SL$$SU 
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The file transfer utility (PCTRAN) permits transfer of data files, library modules, and source program files 
between disk or diskette on a Unisys personal computer (PC) and disk, diskette, or tape on an OS/3 
system. Three user-friendly input screens are used to specify the desired file transfer activity, as well as the 
file names and media locations used by both the host computer and the PC. PCTRAN can also be executed 
in batch mode using an MS-DOS® command (CMD) file. 


SETUP PROCEDURES 


Load the synchronous terminal emulation program (STEP) into the PC and generate the proper UNISCOPE 
(U20) configuration for the PC. This procedure is described in the Unisys Personal Computer Guide to 
Unisys Terminal Emulator User Guide (UP-11886). 

The OS/3 host system must have an ICAM generation with a communications line and U20 terminal 
defined with the same RID/SID as was specified in the PC configuration. The PC can be configured as a 
remote terminal emulating a workstation or as a remote workstation. See the [CAM Programming Reference 
Manual (UP-9749) for OS/3 ICAM generation procedures. 


OPERATING PROCEDURES 


During PCTRAN, you can press any function key to terminate the file transfer and initiate program restart. 


In the normal operating mode, the transfer terminates when the input end-of-file is detected on either the 
host file or the PC file. 


To use PCTRAN: 
1. | Make sure the OS/3 ICAM is ready, and that the communications line to be used is up and available. 


2. Load the PC using the proper PC configuration generated in the setup procedure. For example, if the 
configuration is defined as RMT, the load entry is: 


STEP RMT 


3. Dial up the host system. After the PC successfully connects, the word “Poll” flashes on the right side 
of line 25. 


NOTE: 


Sign on is not required if the PC is configured as a remote workstation and the line definition in 
the ICAM generation specifies DEVICE=(RWS); go to step 5. 


MS-DOS is a registered trademark of Miscrosoft Corporation. 
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Sign on to OS/3 using the $$SON command as follows: 


$$SON TM11REMO 


where TM11 is the terminal ID and REMO is the CCA LOCAP name defined in the ICAM generation. 


The OS/3 logo is displayed. You can now log on in the normal manner. After you log on, perform 
step 5a or 5b, as appropriate, to enter the system mode to initialize PCTRAN. 


a. If the PC is operating as a remote terminal emulating a workstation, simultaneously press the 
ALT and 1 keys to put the PC in system mode. 


b. If the PC is operating as a remote workstation, press the ALT and 4 keys simultaneously to put 
the PC in system mode. 


Once in system mode, enter the following command to initialize PCTRAN: 


PCTRAN index=1-8,CMD= drive:filename.ext 


where: 


INDEX 


Specifies the terminal index number that determines the logical terminal to be used during file 
transfers and batch mode command file processing. INDEX must be set to the same display 
number that is used to initiate PCTRAN. The default is the currently displayed value in the 
Terminal Index field of the control page. 


CMD 


Indicates the PC drive and DOS filename of the command file that contains PCTRAN input 
information for batch operation. 


The file transfer utility loads and the following mode screen is displayed. (See the General Editor 
Operating Guide (UP-9976) for additional information.) 


* OS /3 PC FILE TRANSFER UTILITY * 


VERSION 2R@ 


: RECEIVE CHARACTER DATA FILE FROM HOST 
: TRANSFER CHARACTER DATA FILE TO HOST 
RECEIVE HEXIFY DATA FILE FROM HOST 

: TRANSFER HEXIFY DATA FILE TO HOST 

: TERMINATE PCTRAN 


wi F&F WN = 


SELECT MODE =: (1) 


NOTE: Depress any function key to terminate transfer and restart. 
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@ The next screen displayed allows the host file definition: 
*OS/3 PC FILE TRANSFER UTILITY #* 
TRANSFER TO HOST 
ENTER OS/3 FILE SPECIFICATIONS IN THE FOLLOWING FORMAT: 
MODULE=NAME , FILENAME, VSN, SAT=YES 
OR 


FILE=FILENAME, VSN=VSN,RCFM=VAR 


(TEST, FILTST, VOLTST,SAT=YES ) 
( 


SEE GENERAL EDITOR DESCRIPTION OF FILE SPECIFICATIONS. 
SAMPLE KEYWORDS: MODULE,FILE,VSN,TYPE,DEVICE,SAT 


NOTE: THE OS/3 FILE DEFAULT PARAMETER VALUES ARE AS FOLLOWS: 


DEV=DISK SAT=NO RCFM=FIX 
EXTEND=YES RCB=NO RCSZ=256 
INC=1 INIT=NO SIZE=2 
@ The next screen is displayed to define the PC filename. A new field is displayed when transferring 


character data to allow you to specify whether to translate a tab control character to a space. When 
transferring hex data, this field will not appear. 


*OS/3 PC FILE TRANSFER UTILITY * 


TRANSFER TO HOST 


ENTER PERSONAL COMPUTER FILE SPECIFICATIONS: 
PC DRIVE: FILENAME 
CA: TEST.FIL ) 
NOTE: FILE IS IN THE FORM FILE.NAME.EXTENSION 


TRANSLATE TAB CHARACTER TO SPACE: (Y) 


After normal PCTRAN termination, the following screen is displayed: 


*OS/3 PC FILE TRANSFER UTILITY * 
@ HAS TERMINATED NORMALLY 
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BATCH MODE 


STEP provides the ability to retrieve commands from an MS-DOS file and transmit them to the host 
computer. The commands are sent in a sequential manner in response to information from the host system. 


The PCTRAN user can specify an MS-DOS drive and command filename using the CMD parameter. The 
default filename is the CMDFILE contained on the current MS-DOS drive and directory. 


PCTRAN Commands 
Using an MS-DOS editor or word processor, construct a PCTRAN command sequence similar to the 
following example. In this example the STEP default filename CMDFILE is used. Refer to the Terminal 


Emulator User Guide (UP-11886) for information on command file processing. 


Example of command file contents in CMDFILE: 


Statement Function 

1. X,M,28 Wait for ”(" character in PCTRAN mode screen. 
Set PC menu mode. 

2. >AK1IAK> Send "1" to host and transmit. 

3. >AKFILE=xxxx, VSN=yyyy AKAK> Send OS/3 file parameters and transmit 

4&4. >AKaAKzzzZAKAK> Send PC drive a PC file name 2zzzz. 

5. >AK5AK> or >AK1AK> Terminate (5) or next file (1) and transmit. 

6. X,C,,00 Accept any data string for next batch file 


execution, and clear PC menu mode. 


Execution for this example is as follows: press the CTRL and S keys simultaneously to start the CMD file, 
then type RV PCTRAN in system mode and transmit. 


NOTE: 


If HEXIFY MODE (option 3 or 4) is being used in line number 2, then line number 4 must be 
specified with only one K preceding the second >. 


AK is entered by simultaneously pressing the CTRL and K keys. 
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LOGON Command Sequence Examples 


Sign on and log on to an OS/3 remote terminal can be accomplished by using the following sample 
command file: 


Statement Function 
1.X,C,,1E Wait for “soe”. 
2. >$$SON user - id OS/3 $$SON user-id. 
or 
3. >S$OPEN user-id Telcon $$OPEN user-id. 
4.> OS/3 LOGON IN PROGRESS > Wait for logon screen and transmit. 
5. X,M,,3E Wait for “>” in OS/3 logon screen, set PC menu 
mode. 
6. >AKUSERIDAKAKAKAKNOAKNOAKAK Send logon screen information. 
7. X,C,,00 Accept any data string for next batch file 


execution, and clear PC menu mode. 
NOTE: There are no embedded spaces in line number 6. 


The sample command file below can be used to log on to an OS/3 remote workstation. 


Statement Function 

1. X,C,,00 Accept any data string. 

2. R DUMMY,,, “LOGON” Wait for "DEPRESS TRANSMIT FOR LOGON” 
message. 

3.> OS/3 LOGON IN PROGRESS > Wait for logon screen and transmit. 

4.X,M,,3E Wait for ">" in OS/3 logon screen, set PC menu 
mode. 

5. >AKUSERIDAKAKAKAKNOAKNOAKAK Send logon screen information. 

6. X,C,, 00 Accept any data string for next batch file 


execution, and clear PC menu mode. 


Execution of the logon command file can be initiated immediately upon loading STEP. This is accomplished 
by selecting Y for the “Enable file transfer” and "Start CMDFILE file” of the file transfer options screen of 
the STEP configuration. If the CMDFILE is not executed immediately upon loading of STEP for the OS/3 
remote workstation, line number 2 must not be used. 


NOTE: 


The word LOGON in line number 2 must be capitalized and must have a double quote (”) 
immediately preceding and following it. 


AK is entered by simultaneously pressing the CTRL and K keys. 
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USER GUIDELINES 


The following guidelines apply to PCTRAN: 


The file transfer utility (PCTRAN) supports character and PC hexify mode data transmission; these 
modes are selected by the user. When using character mode, packed decimal fields and binary control 
characters within the data cannot be transferred and are converted to spaces. The EBCDIC characters 
that represent these control characters are: 


0% through 07 
09 through 1A 
1€ through 22 
24 through 27 
2A 

2D through 2F 
32 

34 through 37 
3C through 3D 
3F 


When using hexify mode, the data is translated by the PC terminal emulation software by PCTRAN 
during the file transfer. This option allows you to transfer PC object code and binary data to and from 
the OS/3 host system. 

If transferring OS/3 object, load, or screen format modules to the PC, the data is translated by 
PCTRAN and is maintained on the PC as character data. When the module is transmitted back to the 
host system, it is translated to OS/3 object code format. This facility is activated whenever the host 
type parameter specifies O, L, F, FC, or Menu. 

Data base files may require formatting to sequential format prior to using PCTRAN. 

The maximum record size that can be transferred is 8,192 characters. 

PCTRAN does not currently support MS-DOS filenames that contain the underscore character. 


PCTRAN data transfer is initiated, but is not completed. 


If you initiate a PCTRAN data transfer and the transfer is not completed (the mode screen is not 
redisplayed with a record count), do the following: 


1. Retrieve the STEP control page (press and hold the ALT key and then press the 3 key) to see if 
an error message is displayed. 


2. Press any function key to display the mode screen menu. 


3. Take the necessary corrective action. (See the SSP Operating Guide (UP-8841) for a list of error 
messages.) 


4. _Reinitiate the data transfer. 
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Glossary 


A 


automatic deletion 
A function performed by the linkage editor that automatically deletes control sections and entry points 
previously defined either in the phase being built or in a phase that is on the path of the current 
phase. 


automatic inclusion 
A function performed by the linkage editor that automatically includes object modules in a load module 
for which no definitions exist and these modules are needed for referencing. 


B 


block load modules 
Standard load modules that have been corrected to block format. This format increases the efficiency of 
program loading because all or large parts of the overlay phases may be loaded by a single I/O operation, 
resulting in fewer disk accesses. The program loader can read one track at a time until the entire phase is 
loaded or read only one track that contains one or more entire phases. 


Cc 


code set 
A predefined series of records that make up either a source, proc, object, load module, or a module group. 


common section 
A unit of coding (constants only) that is, in itself, an entity. A common section (COM) is contained in an 
object module. 


common storage areas 
Load module areas that are common to more than one phase of a load module. The size of each storage 
area is equal to the largest size requested by all object module elements referring to a particular COM 
section. 
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control section 
A unit of coding (instructions and constants if a CSECT) that is, in itself, an entity. A CSECT is the smallest 
unit of coding the linkage editor can process. It (CSECT) is contained in an object module. 


current file position 
The position of the file directory at which the librarian begins searching to find a module in a library file 
and continues until the module is found or the end of the file is reached. If the end of file is reached, the 
search begins anew at the beginning of the file directory and continues until the module directory record is 
found or the original current position of the file directory is reached again. (This is not true for gang 
operations.) The current position being arrived at again signifies no-find for that module on the file being 
searched. 


The current position of a file can be affected: 
a by the reset (RES) function; and 
a by any librarian function except the EOD function. 


The RES control statement can place the current position pointer at the first logical record on the file 
specified or at the first record in a named module in the specified file. 


All tibrarian functions except EOD affect the current position. When the function is completed, the current 
position pointer for the processed file is the address of the record immediately following the last record 
processed. 


A COP function may be initiated with no output file specified. This effectively places the current position 
pointer at the record after the last record of the module/group specified in the COP function, without 
actually copying the module or group. 


D 


data set label mode 
The mode in which a diskette is prepped to have a record format similar to tape format. Data set label 
diskettes are used mainly for storing data and contain data set labels instead of a volume table of contents 
(VTOC). 


definition 
An item that can serve as an object of resolution. Such items are CSECTs, ENTRYs, COMs, and linkage 
editor EQUs. 


E 


entry 
An object module symbol dictionary record that supplies a definition for one or more possible external 
references in other object modules. 





exclusive phases @ 


Phases that the linkage editor has determined to be not in the same path (possibly in contention for 
identical storage). 
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exclusive reference 
A reference between exclusive phases. 


external symbol dictionary record (ESD) 
A linkage editor input record containing the information used to define cross-reference (EXTRN, CSECT 
ENTRY, V-CON, COM) when object modules are linked. 


external symbol identification (ESID) 
An index number within a module representing special information with regard to the module’s makeup. 
This information is used by the linkage editor in relocating object modules and object module sections and 
in resolving references between object modules. The system loader also can use this information to 
relocate load modules at execution time. Each of the following items is considered to be related to an ESID: 


& Each symbol associated with an external reference or definition 
a Each text record base address 

s Each V-type address constant 

2 Related relocation masks for text 


® Each control or common section name 


EXTRN 


An object module symboi dictionary record that requests an external definition for one or more references 
existing in the same object module. 


F 


F-type modules 
Screen format modules created by the screen format generator. They contain data type codes and 
input and output instructions used by the application program as it processes the data entered and 
displayed on the screens. (See also FC-type modules.) 


FC-type modules 
Screen format modules generated by the screen format generator. They contain the text displayed at 
the workstation when the screens are used in an application program. (See also F-type modules.) 


file compression 
The squeezing together, by the librarian, of fragmented files (interspersed voided elements), thus 
providing space at the end of the file for new elements. The compression is automatic if merging or 
copying involving the file in question occurs. If not, an existing file may be compressed by using 
certain specific librarian functions. File compression can occur piecemeal within a given librarian job 
stream. Any associated directories also are compressed in the update job. 


file deletion 
The removal of individual modules, groups of modules, or entire code sets from library files by using 
the facilities of the librarian. Deletions can occur during the updating of existing files or the creating of 
new ones. Deletions applied to existing files can cause file fragmentation (as in the case of module 
replacement), which can, in turn, be remedied by later file compression. 
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file extension 
The updating (or effective extension) of a current library file without creating a new output file. This 
may involve replacement of a given element within the file by a new copy of the same element. 
Replaced elements are flagged as nullified and may be removed via a subsequent file compression 
operation. Directory entries for replaced elements in extended files are altered accordingly. 


file merging 
The combining of one or more library files, module groups, or individual modules into a new output 
library (or libraries) by the librarian. Multiple file merging is permitted, and the number of files involved 
is a function of the user requirements. The librarian can merge up to six files concurrently (including 
output files). 


Reference to a seventh file (or more) causes the first file (and any succeeding files) to be reopened 
whenever a new, interspersed file referenced is detected. Thus, merging of multiple files beyond a 
sixth might necessarily be on an exclusive, rather than inclusive, basis. 


format label mode 
The mode in which a diskette is prepped to have a record format similar to disk format. Format label 
diskettes contain a volume table of contents (VTOC) and a VOL1 label. 


G 


gang operations 
Certain functions of the librarian in which types of code may be copied, deleted, added, punched, 
compared, or displayed as a group. These options are initiated via the following command statements and 
the omission of the name parameter (or name and type parameters) in the operand field. 


COP COM 
DEL REN 
ADD 


When the gang mode of the librarian is initialized in one of the foregoing operations, the referenced file is 
scanned from the current position for the code set type designated (unless all modules are being scanned). 
When the module of the type indicated is detected, the requested operation commences. Unless this 
preselected requirement is met at least once, the operation is aborted. 


group 
A set of modules that exist within a specified library file and that may be handled as an entity by the 
librarian. Such module sets may be composed of mixed or nonmixed program elements. There may be 
many groups of the same name in a given library file. 


group management 

The management of mixed module types in a library file; that is, object code, load code, and source-level 
code can be intermingled within a given library file. The librarian can process the elements in a file 
individually or by groups. Via the appropriate gang operation, the librarian can service groups of modules of 
the same or different type through specific functions. Gang operations allow servicing of all modules of a 
specified type within a given library or all modules regardless of type within certain designated file limits. 
For library management, groups may be handled as specified entities by using the library group reference 
method. 
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H 


help screen modules 
Modules containing text displayed at the workstation when an interactive services HELP command is 
issued. These are contained in the system file $YSHELP. 


inclusive phases 
Phases that the linkage editor has determined can be in main storage simultaneously. 


inclusive reference 
A reference between inclusive phases. 


internal symbol dictionary record (ISD) 
A record describing an internal symbol of the program being link-edited. 


J 


jproc module 
A set of one or more job control statements organized in a specific manner (as dictated by the job con.:cl 
processor) and used as input to the job control run processor. 


J-type module 
Saved run library modules generated by the run processor. 


L 


lacing 
A method of minimizing the latency time within a track by offsetting each logical record by a number 
of physical records on a track. This causes the surface to rotate each logical record under the 
read/write head without the loss of a revolution. 


library file 
A specific set of programs residing within the physical limits described by an appropriate file label 
present in a volume table of contents. Library files are herein distinguished from data files in that they 
are composed only of program elements. A library may be composed of multiple library files. 


library file directory 
An index within each library file that facilitates locating elements within that file. Each library file 
contains partitions, and the directory (first) partition is an index into the two prime data (second and 
third) partitions. 
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load module 


A single, multiphase, or multiregion program produced by the linkage editor and ready for system 
execution. 





load module management 

Management, by the librarian, of load modules generated by the linkage editor. The facilities provided 
for load module management are much the same as those provided for object module management, 
except that specific load module phases may be patched. Applied patches are inserted at the end of 
the designated phase. Load modules also may be listed, punched, filed, and renamed. Load module 
listings are hexadecimal printouts of load module records. Load elements may be serviced via all 
standard librarian functions. Phases within a load module also can have an alias phase name, which 
was given to it at link-edit time, in addition to the phase name assigned to the load segment. This 
alias phase name also can be renamed by the librarian. 


logical file name 
As viewed by the SAT librarian, a type code (T=tape or data set label files on diskette; D=disk or 
format label files on diskette) and a number (O—15). This symbolic name identifies all files referenced 
within the librarian control stream. This name normally used to identify a file is equated to a logical file 
name (lfn) at the beginning of each librarian run. For MIRAM library files, the Ifn is a type code (F) and 
a number (0-29). 


M 


macro module 
A set of one or more source code statements (BAL instructions) used as input to the macro facility of the 
assembler. Macro modules can be written in two separate formats: macro and proc. The name given the 
macro in the PROTOTYPE statement in the macro format can be the same name as the one given on a 
NAME statement in proc format in the same file; however, the name on the PROTOTYPE statement cannot 
have the same name as the one given in the PROC statement in the proc format. 





mapping facilities 
Facilities that produce a map of the functions the librarian performs each time it is executed. The map is 
output on the system printer for the user. The map normally includes: 
a A listing of all the librarian control statements processed 
. A printout of all the header records processed 
. Any appropriate diagnostic messages 
Additionally, the map can include: 
o Source module listings 


. Object and load module listings 


® Module correction results (insertions versus deletions) 





otherwise, it reflects the state or content of the input file serviced by the respective librarian function. In 


comparison functions, discrepancies are listed one above the other on a record-by-record or block-by-block 
basis. 


The map normally reflects the state or content of the output library files if one or more were produced; & 
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& module 


A program element existing in either source, proc, object, or loadable program format. These elements 
serve as input and output of various system functions. Different module types may be mixed within a given 
library file or segregated in separate library files at the discretion of the user. 


module gang mode 
The mode in which gang operations are to be performed on modules of a specified type. In this mode, the 
module name is omitted and the type positional parameter is set as follows: 


S For source modules 


M For proc module 
0 For object module 
L For load module 


By setting the type as shown and by omitting the name, the user instructs the librarian to perform the 
designated operation on all modules of the type specified from the current position of the library file up 
through end of file. 


module group 
A group of one or more source, proc, object, or load modules that are prefixed with a beginning-of-group 
demarcator record and an end-of-file sentinel record or end-of-group demarcator. Like a module, a module 
group may be treated as a single entity by the librarian. 


@ multiphase load modules 
Modules constructed by a programmer to minimize the main storage requirements of a program. They 
consist of more than one program segment, with each segment being a phase that may be loaded into 
main storage and executed individually as required by the logic of the program. Each phase of a multiphase 
load module is composed of individually assembled and/or compiled sets of code that may be thought of as 
a program subroutine. Further, each phase in a multiphase load module can be made to overlay one or 
more previously executed phases in main storage. 


The main storage location at which a phase is loaded is called a node point. All the phases in a multiphase 
load module, excluding the root phase, are loaded in main storage at a node point. Node points and phases 
are defined through the linkage editor OVERLAY and REGION control statements. 


The INCLUDE statements following an OVERLAY or REGION control statement identify the object 
module elements that are to comprise the phase. Ignoring the root phase, the number of phases in a 
multiphase load module coincides with the number of OVERLAY and REGION control statements 
present in the control stream that caused its generation. The root phase of all load modules is initiated 
with the initiation of the load module, normally in response to a LOADM control statement. 


multiregion load modules 
“Modules that are basically the same as multiphase load modules, except that a multiregion load module is 
so constructed that the origin of the first phase of each region is at the end of the longest path defined in 
the previous region, rather than at the end of the phase previously defined. This feature prevents the 
phases in one region from overlaying any portion of a phase in any other region. 
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In general, a load module constructed as a multiregion load module normally requires more main storage @ 
space for execution than the same program configured as a multiphase load module. Multiregion 
structures are most useful, however, when a need exists for a phase to reside in an area where it will not 
be overlaid by other phases that may not be directly associated with it. Also, it is sometimes possible to 
realize an actual saving in main storage space with a multiregion construction when one or more control 
sections are required for two or more distinctly separate phases but are not required by any other phases. 
In this case, these CSECTs could be placed in a separate region, rather than being embedded in a phase 
common to the phases requiring them. Placing them in a common phase could unnecessarily affect the 
origins of succeeding phases even though the majority of these phases do not require these CSECTs. The 
opposite is true when these CSECTs are placed in a separate region. Region origins always are assigned at 
the end of the longest path of the preceding region, and unnecessary placement of CSECTs in separate 
regions may have an adverse effect on the overall length of the load module. 


Regions are declared by the programmer with the REGION control statement in much the same way a 
phase is declared with an OVERLAY control statement. Both statements initiate construction of a new 
phase at some symbolic starting address, or node point, specified in the control statement. The only 
difference between the two statements is the way they cause the linkage editor to assign an origin to the 
phase being created. 


N 


naming conventions 
The conventions used to name modules. Modules within library files (regardless of type) contain an 8- 
character EBCDIC identifier that is used as the name of the module. (Modules of the same name and type 
are not allowed in one file.) If the name assigned has less than eight characters, it is left-justified and 
space-filled. The exceptions are nonalias load module phase names, which always contain only six 
significant digits (EBCDIC, left-justified and space-filled); the least significant two characters specify the 
phase number (00-99 EBCDIC). Naming of specific modules can be performed at: 





assemble/compile time for object modules; 


link-edit time for load modules; 


library services time for source-level and macro definition modules; or 


file time for jprocs and job control streams. 
The librarian also can be used to rename specific modules or module groups. It can: 


rename a source-level or macro definition module; 


- rename an object module or a specific CSECT; 
- rename common sections and ESD records in object modules; 
- rename all phases of a load module (retaining phase numbers); and 


- rename the alias phase name of a load module phase. 


node point rd 


The starting, or origin, address of each loadable phase (which also is the terminal address of a previous 
phase), or the address of a definition in the same path of a phase. 
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@ nonreentrant code 


Code that is self-modifying. Consequently, only one copy of this code may be executing at any one time. If 
more than one execution is occurring simultaneously, the code will not produce the desired results 
because one execution path will be using information pertinent to another execution path. 


nullified module 
A module logically marked for future physical deletion by the librarian. A nullified module cannot be 
accessed by either system or user programs. 


O 


object module 
A set of one or more control sections of code produced by a language processor. 


object module management 
The procedure by which language processor output modules can be maintained by the librarian, in that 
object code can be patched, listed, punched, filed, and renamed. Specific CSECTs or ESDs also may be 
renamed. Patch corrections are inserted at the end of the object module. Listings of object modules are 
hexadecimal printouts of object records. All standard librarian functions regarding module manipulation 
apply to object elements. 


Whenever nonsource elements are serviced, they are checked for proper content and record sequence. 
Discrepancies trigger diagnostic processing. 


Object modules can be designated as being reentrant by the librarian, so that the linkage editor can set up 
linkages to a shared load module rather than including the object module in the load modules needing it. 


p 


partition 
A logical portion of a library file that contains either an index for the file or the program data for the file. 


path 
A path determined by one phase leading into the next phase and so on. This allows label references in a 


load module to be traced from one phase backward through each preceding phase between it and the root 
phase. No more than 14 phases are allowed in any one path. 


phase 
A portion of a load module that can be loaded as an overlay by a single execution of a supervisor LOAD or 
FETCH macroinstruction; also called a load segment. A load module can consist of up to 100 phases. 


phase dependencies 
Whenever a phase is in main storage or is being loaded in main storage, all the phases in its path from 
start of module or from start of region also should be in main storage. Phases may be loaded in any 
numerical sequence whatsoever, excluding the root phase, and reloaded any number of times, as required 
by the logic of the program. The assigned location of the phases has no bearing on the order in which the 
& phases are executed. Any part of a phase that is modified during its execution will remain so only until the 
phase is overlaid. 





UP-8842 Rev. 3 SPERRY OS/3 Glossary 10 


SYSTEM SERVICE PROGRAMS 





phase names 

Names that identify the various phases of a load module when they are loaded in main storage for program 
execution. (Programmers who wish to do their own program loading, rather than have the automatic 
overlay region control mechanism of the linkage editor embedded in their load module, must reference a 
phase name in a FETCH or LOAD macroinstruction whenever a phase is to be loaded for execution.) Each 
phase is automatically assigned by name by the linkage editor. This name is based on the name assigned 
to the load module by either the programmer or the linkage editor. An alias phase name also may be 
assigned to each phase through the OVERLAY or REGION control statement that causes its generation. 
The assignment of alias phase names allows the programmer to reference the phases of a load module in 
his subroutines or phases without knowing the order in which the phases will be defined in the linkage 
editor control stream. The linkage editor automatic overlay control mechanism always refers to the linkage- 
editor-generated phase names. 


preamble SEXTRN processor 
A piece of code that resides in the user prologue that completes the transfer of control from a program to a 
shared code module outside the program. The SCON value in register 15 is converted to the machine 
address of the shared code ENTRY. The shared code routine is given control exactly as if it were included 
with the calling program. The content of the 4-byte SCON in main storage is not altered during this 
process; only register 15 is altered. 


program length 
The length, of an overlay program, that must be considered in building a user program. The length of the 
longest path is the minimum storage requirement of an overlay program. Also, when a program is built 
with the automatic overlay mechanism, the storage requirements of the necessary control routine, entry 
table, phase table, and possible region table also must be considered. 


program library 
All program modules existing within a given system complex or user environment. 


program source module 
A set of one or more source code statements used as input to language processors or as data for a user 
program. 


R 


reentrant code 
Code that does not write to its own area. Reentrant code can be used by more than one program in a 
multiprogramming environment simultaneously. When more than one program is using reentrant code, 
only one copy of the code needs to be present in main storage. (See shared code.) 


region 
A contiguous area of main storage within which assigned load module phases can be loaded independently 
of phases in other regions. Up to 10 regions may be in a single load module. 


resource 
A reentrant load module that is needed by a nonreentrant load module for its proper execution. The 
operating system schedules the nonreentrant load module when the resources (reentrant load modules) 
are available. 


resource number 
A number, unique to each load module, that is assigned to each resource record by the linkage editor. 
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resource record 
A record produced by the linkage editor that names a shared module required for the successful execution 
of the load module being created. There may be several resource records per load module. 


RLD mask 


An object or load module relocation mask used to specify text modification. 


root phase 
The phase that is the first order of storage allocated to a load module. 


root segment 
The segment that controls the phases and the order in which they run as specified by phase O. The root 
segment contains common constants and subroutines used by more than one phase and storage space for 
information being passed from one phase to another. 


When the routine is executed, control is passed to the root segment. The root segment passes control first 
to phase O and then to the other phases. When a phase is completed, control always is returned to the root 
segment. 


S 


saved run library modules 
Modules containing translated job control streams that have been saved in the system file SY$SAVE 
through the job control SAVE option. 


SCON (shared constant) 
An ACON or VCON that got resolved to a shared module. It has a 4-byte value - the high byte contains the 
SINDEX number of the SEXTRN, and the three low bytes contain a negative address (address of preamble 
SEXTRN processor). 


SENTRY (shared ENTRY) 
All definitions (CSECTs, EQUs, and ENTRYs) encountered in the link of a shared module. 


SENTRY number 


A number, unique to each load module, that is assigned to each SENTRY of a shared module. 


SENTRY record 


A record produced for each SENTRY found during the link of a shared object module. It will contain the 
SENTRY name, its link origin, and SENTRY number. 


SEXTRN record 
A record produced by the linkage editor that describes a SEXTRN. This record contains the SEXTRN name, 
its SINDEX number, and the resource number of the module it successfully got resolved to. 


SEXTRN (shared EXTRN) 


An EXTRN that successfully got resolved to a shared module. 


shared code 
A piece of code that does not write to its own area: that is, reentrant code. Normally, this code expects its 
user to pass it a pointer to a work area through a specified register. In OS/3, shared code may be delivered 
with the operating system (e.g., shared data management) or written by the user himself. Shared code is 
assumed to be in object module form and its linked version as a load module. 
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shared definition 


A definition that is contained in a reentrant object module. 


shared record 


A resource, SEXTRN, or SENTRY record. 


SINDEX number 


A number, unique to each load module, that is assigned to a SEXTRN. 


single-phase load modules 


Modules that consist of a single program segment that is loaded into main storage each time the program 
is executed. The storage structure of a single-phase load module can be represented by a single horizontal 
line whose length is relative to the amount of serial storage locations required to store the load module in 
main storage. All load modules generated by the linkage editor start out as single-phase load modules and 
are created only as multiphase or multiregion load modules if so directed through OVERLAY and REGION 
control statements in the input control stream. Thus, single-phase load modules are modules that consist 
solely of a root phase; multiphase and multiregion load modules consist of a root phase plus one or more 
phases. 


source module 


A set of one or more source code statements used for input to language processors or the job control run 
procedure. 


source/proc module management 


The facilities provided by the librarian for the maintenance of source or proc code modules. The 
librarian can maintain copy, proc, and macro definition modules as source-level code modules for 
processing. Source-level code modules can be listed, filed, punched, corrected, and renamed, as well 
as handled with the standard librarian-provided functions. Specific source records can be added and 
deleted from a source element. Updated source-level modules may be mapped as corrections are 
applied. Source records are printed individually in 80-byte EBCDIC format. 


spiraling 


A method of minimizing track-to-track latency by skipping a predetermined number of physical records 
when numbering logical records from track to track. This causes the first logical record of each track to 
appear to Spiral in relation to its physical index marker. Thus, when the read/write head moves from track 
to track, each logical record is accessed without the loss of a revolution. 


system library file 


A permanent system file containing system programs and existing in support of the operating system. The 
OS/3 system library is composed of five permanent system library files and a temporary system job run 
library file, as follows: 

1. System load library file (SY$LOD) 

2. System object library file (SYSOBJ) 

3. System source library file (SY$SRC) 

4. System macro library file (SYSMAC) 


5. System JCS library file (SY$JCS) 


6. System job run library file (SYSRUN) 
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The preceding breakdown is defined by the operating system. OS/3 supports the system job run library file 
only for the duration of each job. This file acts as the default file in cases involving different system 
programs. Library files may be composed of both user and system programs. Such a mix is transparent to 
the librarian. 


system program library 
All system program modules for a given system. This library exists in support of the operating system. 


T 


Text 
Records containing the actual instructions and data associated with a particular object module control 
section or load module phase. 


total gang mode 
lf the function to be performed does not concern itself with a specific module or code set, the type and 
name positional parameters must not be specified. In this case, an entire library (or remainder of one 
prepositioned) may be manipulated via the facility desired. The gang operations always process the library 
file from its current position as defined by the respective file table (DTF) contained within the program. 


transfer record 
A unique record signaling the end of an object module or load module phase. 


tree 
The graphic representation that shows how load module phases can use main storage at different times. 


type 
A specific indication of the classification of the program module or record being referenced within a given 
library file. 


U 


update records 
As defined by the assign alternate track routine, records correcting errors that are encountered when 
reading from a defective to an alternate track. 


user library file 
A private user file containing user worker programs existing in any or all of the specified formats. This is a 
permanent file existing in support of the user. A user library may be composed of multiple user library files. 


user program library 
All user program modules for a given system. This library is private and comprises all user worker 
programs. 
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V 


V-CON 
A special reference to an external symbol that may exist in an exclusive phase when the program has been 
link-edited and that may require automatic loading of an exclusive path. Such a constant may not be used 


to reference data; it is used only for branching. 
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